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ABSTRACT 


This thesis describes the development of a magnetic tape 
library system (TLS) for the Computer Science Department of 
the Naval Postgraduate School, Monterey, California. The TLS 
was developed using the Ingres VM UNIX Version 2.1/15 VE.04 
database management system on the 4.2 BSD UNIX operating sys- 
tem. The thesis includes a requirements analysis and design, 


and a description of implementation. 
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Pec hODUeC ETON 


The Computer Science Department maintains a variety of 
magnetic tapes for their instruction laboratory. The current 
combination manual/computerized library system is ineffi- 
cient. The department wants a computer-based system by which 
librarians may add, locate, update, and provide reports 
regarding tapes in the library. There are currently six li- 
brarians who are staff members of the department. In addi- 
tion to their librarian duties, they are responsible for some 
form of maintenance of the department's two VAX 11/780 and 
one VAX 11/750 computers. The maintenance administration is 
performed with the VAX 11/780/UNIX operating system. The 
department wants a tape library to be developed using the 
Ingres (VM UNIX Version 2.1/15VE.04) database management sys- 
tem (DBMS), the 4.2 BSD UNIX operating system. 

The database development process will be used to build a 
tape library system (TLS). It will be developed in ely 


stages -- requirements specification, evaluation, design, and 


implementation. 


fer eOQULREMENTS SPECIFICATION 

The management of the Computer Science Department has 
already defined the need, and estimated the cost/benefit of 
the project. They approved its continuation when they re- 


guested that the library be developed by a thesis student. 


The current tape library 1S a combination oi a Ccasuem 
computer listing of approximately 600 tapes, and opened 
cabinets in which tapes are segregated by type. 

The library system must facilitate use by the six Mli- 
brarians. The need to store and catalog tapes dependably 
is critical. It must ensure the security of the data. 
tapes. Guidance for logging data must be well defined and 
interactively prompted to ensure input of ail necessai, 
INfOrmMatLon. 

Development of the library by a thesis student for use on 
the VAX 11/780/UNIX operating system and Ingres database will 
keep costs to a minimum. No new hardware, software, or per- 
sonnel purchases will be required. Because all the 1librar- 
lans have extensive experience with the system, minimum 
training will be reguired. This thesis describes development 
Gf the Vis. 

Detailed user reguirements will be determined by exten- 
Sive interviews with the users. The department has assigned 
a user team leader. The current system and desired changes 
will be documented in Chapter II by a narrative and data flow 
diagrams. The proposed system will be documented by data 
flow diagrams, process mini-specifications, data items, and a 
specification data’ dictionary. The new system will be re- 
Viewed and approved by the users before the evaluation stage 


COMMENCeS = 


B. EVALUATION 

The evaluation stage will be limited because the depart- 
ment has already delineated the system hardware, operating 
system, application language, data technology, and people. 
The database design, application program, and procedural 
alternatives will be developed for evaluation and selection 
by the user. A project plan, outlining major development 
tasks, will be documented for use by the developer and user 


in following project development. 


fe) DESIGN 

The design stage will include definition of the database 
structure application program, security and control, and 
functions of the database administrator. 

In Chapter III, the database structure will first be 
defined logically, indenenaeuenos the requirements of Ingres, 
according to the rationale of the data record relationships 
and fields. These relationships will be illustrated by data 
structure diagrams (Bachman diagrams). They will be defined 
in a logical schema. 

In Chapter IV, the logical structure will be mapped to 
the physical structure of Ingres. tiew Sselations, data, 
formats, and the functions and interfaces of the modules will 
be included in the design data dictionary. The application 
program will be designed in parallel with the database 


design. Security and control procedures will be designed 


into the application program to ensure that only authorized 
users may access the library. 

A tutorial will be developed in parallel with the appli- 
cation program and will be included as Appendix G. It will 
include operating procedures, security specifications, and 
the database administrator's responsibilities for mainte- 


nance of the library. 


Ble IMPLEMENTATION 

The application will be coded in the Ingres DBMS lan- 
guage. A small representative database will”be loaded into 
the database. All modules will be tested. Users will be 
trained. Full loading of the 600 tapes will be accomplished 
by the staff librarians. Instructions for implementatieneeme 
provided in Appendix F. Final conclusions and recommenda- 


tions will be included in Chapter V. 
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II. REQUIREMENTS ANALYSIS 


A. NARRATIVE 
im Background 

The Computer Science Department's current tape li- 
brary is a combination of a casual computer listing of 600 
tapes, and opened cabinets in which tapes are segregated by 
type. Tape labels contain as much information as possible in 
case the information in the library listing is inaccurate, 
incomplete, or nonexistent. The information in the listing 
1s not standardized. It consists of whatever one of eight 
librarians considered necessary for identification or re- 
trieval when (s)he entered the tape into the library. Fre- 
quently customers help themselves to shelved tapes, and new 
boxed tapes sometimes disappear. Few staff and student 
personnel request the library to store their tapes. ~- The 
department would like to provide secure, dependable library 
services. 

Compounding the problem, the computer facilities are 
rapidly expanding. Dependence on the facilities is increas- 
ing and people are requesting better library services. Con- 
currently, requests for backup tapes are increasing as is 
the length of time between when a backup is created and re- 
trieved. More tapes are getting lost. The need to store and 


Catalog tapes dependably is critical. 


Nem 


2. Users 
Approximately six to seven staff personnel, all 
extensively familiar with computers, perform librarian duties 
and will have access to the library and tapes. Because of 
the large number of librarians, guidance for logging data 
must be well-defined and interactively prompted to ensure 
that all necessary information is input. 
Seo eOrage 
The tapes will be stored in locked cabinets with sep- 
arate slots for each tape. The staff would prefer not to 
physically separate the tapes by category and not to have 
descriptive information on the tape labels. This will help 
to prevent customers from helping themselves to tapes they 
need if cabinets are inadvertently left unlocked. Only Vee 
librarians should have access to the tapes. 
4. Tape Entry 
Tapes are received into the library in three ways: 
1) boxes of new tapes; 2) tapes from vendors, and 3) written 
tapes requested for safekeeping by private owners. To pre- 
vent pilferage, it is desired that new tapes be identified 
and placed into the library immediately. Physical informa- 
tion about these blank tapes must be included. They will 


eventually be used to write backups. Vendor tapes are iden- 


tified and catalogued as soon as possible. They are never 
retired for use as backups. Tapes input for safekeeping must 
be identified. If abandoned by the user, they may be used 


2 


for backups. Essentially, the moment a tape is received by 
the library, it should be identified with as little informa- 
tion as possible on the label. It should be labelled with an 
identification number only, which can be used to locate 
assigned space in the cabinet and its descriptive information 
iaeeaie library. 
5. Backups 
It is the function of the tape librarians to perform 
backups. They do routine system backups, and "individual" 
Beemups bY special regquest for staff, faculty, or student 
personnel. For individual requests, the owner's tapes main- 
tained by the library may be reviewed to determine if there 
is sufficient space available on one to read the disk files. 
requested to the partially used tape. To perform an individ- 
ual backup when an appropriate, partially used tape cannot be 
fmemmd, Or to perform any other backup, the librarian must 
first find a "scratch" tape, either new or previously used. 
mmemust be of sufficient condition, density capacity, and 
length to accommodate the backup. After the information = on 
backup tapes is retired, the librarian makes the tape avail- 
able for rewrite. 
a. Routine Backup 
Daily disk backups are written to tape each week. 
Weekly, disks are written to tapes. Full backups of the 


eerem are written to tape monthly. Information kept in the 


IDS 


library must enable the librarian tO access the tapes Jame 
write them back to disk. They must be identified) by en. 
date and time of backup, the system, utility, software used 
to generate the tape, and path information such as partition 
Or “disig, “OG “source: Each daily backup is 1-2 tapes long, 
weeklys require 2-3 tapes, and monthly's 4-6 tapes. The 
library will save dailies for one month, weeklys for two 
months, and monthlys for six months. 

When a Computer Science class graduates (14-17 
students) the librarian creates a tape backup of graduated 
student disk files for each system. Each is i> tapes long. 
Again, the librarian must find a tape of the appropriate 
length, condition, and density capacity. After writing the 
tape, the librarian must catalogue information which will 
enable retrieval of a student’s files to write them to comes 
Or another tape. This information must include date, student 
name, the specific files, the operating system hardware and 
utility used to generate, and device. The tapes will be kept 


fOr two years. 


DATA RETENTION 


DAILY BACKUPS 1 MONTH 
WEEKLY BACKUPS 2 MONTHS 
MONTHLY BACKUPS 3 MONTHS 
GRADUATION BACKUPS 2 YEARS 
INDIVIDUAL BACKUPS 2; YEARS 
VENDOR BACKUPS Sean 
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b. Nonroutine Backups (Individual Tapes) 

Staff, faculty, or students frequently request 
that a disk file be written to tape. The librarian first 
checks to see if the individual currently owns a tape in the 
library of the same system, copied with the same utility and 
device as required to access the file(s), that has a suffi- 
cient unused portion to write the file(s) requested. If an 
appropriate tape is found and used, the addition of the new 
file(s) must be recorded into the library. If there are 
none, the librarian must look for an adequate scratch tape. 
If a new tape was used because the owner med no previous 
tape(s) on file, the librarian identifies it as a new set 
with a new sequential order. A set of individual tapes can 
include up to three volumes. After copying the tape, the 
Meteaetan Catalogs the information necessary to find which 
tape the new file is on and how to write it to disk or 
another tape. 

6. Administrative 
a. Condition of Tapes 

Thieme. tbscarian lsemeesponsible fer monitoring™the 
condition of the tapes and to recopy or throw out tapes as 
required. Condition is determined in one of two ways: errors 
and bit age. 

CE we nEors 

Errors are unreadable bit spaces on the tape 


and are communicated to the librarian by the utility each 


nS 


time the tape is read or written. Ten to twelve errors 
(after head cleaning) is considered maximum life. The 
librarian must catalogue this information each time the 
physical tape is read or written. Physical tapes exceeding 
their maximum cycle or error life are permanently deleted 
from the library and thrown away. 

(2) Bit Age 

Bit age has to do with the information 
written on the tape and applies only to active tapes (vendor 
or backups). It is the age of the oldest bit on the tape. 
Bits deteriorate after five years so the wane informakeaion 
must be copied to another tape. The physical tape, however, 
may be reused. Checks for bit age must be done on all tapes 
on a periodic basis. 
b. Retirement of Tapes 

The librarian requires a flexible means of con- 
trolling the length of time all active tapes are retained by 
the library, other than by condition. The reasons could vary 
per type of active tape. When the retirement date occurs, a 
disposition decision will be made. 

c. Lending of Tapes 

Vendor, scratch, and individual tapes may be 

loaned. The library must maintain information regarding 


which tapes are on loan, and to whom. 


7. Deleting Tapes 
Backup tapes may be retired to scratch tapes, or any 
tape may be thrown away. For retiring backups, the librarian 
must provide a means to delete backup information but retain 
the physical tape information. It must allow deletion of all 
tape information and reflect the availability of a vacant 


labelled slot in the cabinet when a tape is thrown away. 


B. DATA FLOW DIAGRAMS (DFD) 
ie Current Library 
An overview of the current TLS described in the 
narrative is illustrated by a DFD (Figure 1). Minispecifi- 
cations and file descriptions follow the DFD. 
2. Proposed Library 
A general overview of proposed library procedures is 
reviewed in DFD(O) (Figure 2). All procedures are to be per- 
formed by a librarian. Subsequent DFDs (Figures 3-10) are 
more detailed. The procedures are numbered 1-9. The pro- 
cedures and data input and output for each procedure varies 
Meeeording to the function the librarian performs. A DFD is 
Written for each function to illustrate the specific proce- 
dures and data inputs and outputs required. Functions are 
assigned letters A-H. Mini-specifications of the procedures 
and a specification data dictionary follow each DFD. The 
Beocecure numbers of the functional DFDs match the procedure 


to the definition provided in the overview DFD(O) and are 


preceded by the appropriate function letter. For example: 
"A.2”" should be read — FUNCElONMA Gwe occdure. 2. 

For some functions, a procedure is broken down into 
sSub-procedures. Sub-procedures retain the function and pro- 
cedure number, followed by a decimal number (i1.e., A.2.1 
should read - Function A, Procedure 2, Sub-procedure 1). 

Cabinets and the database will be the only files used 
to store library objects and information. Cabinets will con- 
Sist of labelled slots, consecutively numbered left to right, 
EOD tO bor EOM, The range of the numbering system will be 
expanded as tapes are added. Cabinets will be Saoen by the 
range of numbers’ assigned. For example, a cabinet may be 
known as 200-300. 

The library data will be the only source of infor- 
mation regarding labelled cabinet spaces, the physical con- 
dition of tapes assigned, and the data preserved on active 
tapes- (vendor tapes and backup tapes). A backup tape is a 


tape with information which the library safeguards. 
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MINI-SPECIFICATION: THE OLD SYSTEM LIBRARY ~ OVERVIEW 


1. Edit Request The libeartan Ome equccror edits the re- 
quest at this time to determine what 
actklonm Wemeake. 

2. Query for The requestor or librarian searches for 

Tape (s) the tapes which will satisfy the request. 

3. Select The librarian or requestor selects the 

Appropriate equipment, if required, to satisfy the 
Equipment request. 
4. Get Tape(s) The librarian gets appropriate tape(s). 
5S. Perrorm The librarian or requestor performs the 
Read/Write read/write, if required. 

6. Return Tape(s) The librarian returns the tape(s) to the 
cabinet; the requestor might or might 
ghehene 

7. Update The librarian updates the database; the 

Database requestor does not. 
PLES 
Four objects serve as files in the current library: 

CABINETS Cabinets have slots which hold the tapes. These 
slots are not numbered. The tapes which are 
contained in them have labels with numbers and 
tape information. An attempt is made to place 
reels of similar systems and tapes in specific 
sections of the cabinets. The cabinets are 
opened and easily accessible to anyone at NPS. 

DATABASE A vaguely defined computerized file of tape num- 
bers with information for the librarian regarding 
the tape. Information required to perform subse- 
quent functions is frequently omitted. This data 
is also written onto the tape label. 

NEW BOXED New tapes received are left in boxes near the 
cabinets. The physical parameters of the tapes 
appears on the labels. The Lox is accessible to 
anyone. 

oar 


Tapes sometimes disappear. 
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Proposed System Overview 
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Function: General Procedures of the Proposed Library 


Mini-specifications O 


The following procedures are required by most of the 


functions the librarian performs. The combination of pro- 


cedures and the data input and output for each procedure will 


vary according to the function requested. 


eee 


2. Query TLS Data 


a Select IDs 


4. Label 


so Gee Tape (Ss) 


oe Perform 
Read/Write 


7. Replace Tape(s) 


8. Update TLS Data 


An event/discussion with a requestor 
to determine the function required. 
For example: 


Add empty cabinet slots 
Add scratch tapes 
Add vendor tapes 
Write disks to tape: 
To partially used individual tape 
To backup tape 
To scratch tape 
Read active tape to disk 
Loan Tape 
Receive returned loaned tape 
Delete tapes 


Provide criteria upon which the 
information requested is retrieved. 


Select the id numbers which are 
required to perform the function. 


Make labels for, and label objects for 
each id number selected. 


Go to the cabinet slot labelled wim 
the selected id number and withdraw 
the tape(s). 


Perform write disk to tape or read 
tape to disk, aS appropriate. 


Replace tape(s) to the cabinet slot 
whitch Matenes the tdents £ resto 
number on the tape label. 


Add to, or update TLS data with new 


information regarding the operation 
performed. 
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Function: 


Add new scratch Tapes to Library 


Mini-specifications A 


ile Die nae 
E@Gsceraren 


Jae Query 
Empty Slots 


3.1 Calculate 
New id 


3.2 Assign id(s) 


4.1 Label Tape(s) 


4.2 Label Cabinet 


Sue Add “Scraren 


Data Items 


Physical 

Type 

Elieiy Sito. id 
None 

New id Selected 
Labelled Tape 


Label 


Scratch Recore 


Request to log scratch. Log new un- 
labelled tape(s) upon arrival. Read 
physical parameters from manufacrer's 
label. 

Query library data for lowest empty id. 
If no empty slots are available, 


calculate new id number 


Select the id(s) to assign to the 
scratch tape 


Label the tape(s) with the’assigned slot 
id number. 


Label the cabinet space with the new id 
If 1d was of an empty slot, update tape 


physical parameters to the id record. 
If new id, add id and tape parameters. 


= length + density 
= (type = empty) 
= id + (type = empty) 


= no empty slots 


Max 1a 5+) 1 
= Tape + id 


= a label with an id number to be put 
on the cabinet space 


id + (Type = scratch) + length 
+ density 


DED (B) 
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Mini-specification B 


yee Pate yencoe ir 


oa Query Empty Slots 


3.1 Assign id(s) 


3.2 Calculate New 
id Numbers 


4.1 Label Tape(s) 
4.2 Label Cabinet 
Space (s) 
So. Add Vendor Tape(s) 
to. Tis 
Data Items B 
Physical 


Software 


Type 
plot. se 
None 
New id 


Software Tape Record 


The tape is software from a 
vendor for the library to loq@ang 
maintain 


Query the library data for lowest 
empty id 


Assign the id to the vendor tape 


If no empty slots are available, 
calculate the new id number 


Label the tape(s) with the 
assigned slot id number 


Label the cabinet space with the 
new id 


Add software tape(s) record to 
the library data 


= bpi 

= (type = vendor) + system + 
utility + labél + date 
received + retirement date + 
owner + contact phone + soft- 
ware + vendor + description + 
seguence 

= Type empty 

= id + (type = empty) 

= No empty slots 


= | ec wee eo! 


= id + (type = vendor ) + bpi 
+ software 
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Function: Write Individual's Disk to Tape 


Mini-~specification C 


ie EGite \WErce 
Disk to Tape 


ilinapale Determine File 
bOGaeton anda 
Length of Files 


2 Select Equipment 


25 Query Owner's 
Tape (s) 
oes Selett Tape 


Deli Go to 
Procedure D.1.2 


Di Get Tape 

one Perform Backup 
ve Return Tape 

ie Update TLS 


If type = individual staff, 
faculty, Om sScudene Dackup: 
Jee gic) (ele) ec as BBB) | as ee 


By discussion or may require 
searching files. 


The computer and operating sys- 
tem combination determines the 
device. The device determines 
the density which can be used. 


Query the library data for a 
listing of the owner's backup 
tapes which may be used to copy 
the files requested. 


Select a backup tape which may be 
used to write the requested file. 


If none of the owner's tapes are 
appropriate to use, go to Proce= 
dure 1.2 o£ DFD{D) and resume 
looking £or a semuatch tape te 
perform the write. 


Write disk files to the tape. 


Add the record of the new files 
to the library data. If the 
utility reads error information 
different than that recorded for 
the tape, update. 
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Data Items C 


Type 


Owner 


Approximate File 
Path 


‘Lyigels 
Density 


Tape Requirements 


Owner Tape Listing 


File Path 


File Lengths 


Pea lity 


None 


Becors 


Record of Backup 
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Pein eeUcineestart, —raculty, Or 
Student backup 


the owner of the individual 
backup tape 


(Some or all) (system + owner 
Fe pared Oly Ginsk ) 


Ind ivgeewalrmstark, staculty, or 
student 


Ose = jee “shevelgl: (eyet 

(some or all) (type = indivi- 
dual) + owner + system + 
density 

id + length + density + loaned 


Soo tcettet  UEllityer label, 
percent used + retirement date 


Partition/disk + saveset/ 
Source 


Approximate length of magnetic 
tape needed to copy the files 


Uitecieleietes 


No tapes meet the requirements 
fOr the backup 


BR@n@Obew Gare Of Errors 
iM—~P=——errors + date Of errors 


+ partition/disk + saveset/ 
source 
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PUM@eEnOn:s —NWritte Disk to Scratch Tape 


Mini-specification D 


ie Edit: Write Disk tee y Oem dative weekly, monthly, 
me scratch Or graduation backup 

1.1 Determine By discussion or may require 
File Location searching files 
and Length 

1.2 Select Equipment The computer and operating system 
Required combination determines the 


device. The device determines 
the density which can be used. 
The utility is determined by the 
system and the density 


Zz. Query Scratch Query the database for scratch 
tapes which have the physical 
parameters required by the edit 


procedure 

Bre Select Scratch selects tds from the listing of 

Tape (s) scratch tape(s) provided by the 

database 

Dis Get Tape(s) Retrieve tape(s) with the id(s) 
selected 

O. Perform Backup Write disk files requested to 
the tape 

i Return Tape(s) 

e. nad to TLS Eieoreweteominrormatlon regarding 


the backup to the library data 
Data Items D 


Function: Write Disk to Scratch 


Approximate File “Soe vewor ea ene (System + part/disk + 
Path saveset/source) 
Type Backup = daily, weekly, monthly, graduation, 


GCmeineaividual packup 


Type Tape = Type = scratch 


Bel 


Density 


Tape Requirements 


Scratch Tape List 


File Length 


File Path 
Equipment 

BEroes 

Equipment 

Record of Backup 


Daily 


Weekly/Monthly 


Graduation 


Individual 


bits per vanch (or) 


(Type = scratch) + hengthy+ density ae 
errors + date of "errors 


id + length + density + errors + date 
of errors + loan 


Approximate length of magnetic tape 
needed to copy the file(s) 


Partition/disk + saveset/source 
System + utility + density 
Error + date of errors 

System + utility + density 
Various according to type: 


id(s) + type + errors + date of 
errors + label + sequence + date 
created + retirement date + system + 
utility + description + parelered 
disk + saveset(s)/source(s) 


id(s) + type + errors + date of 
errors + label + sequence + date 
created + retirement date + system + 
utility + description + partltvon 
disk + saveset/source 


id(s) + type + errors + date of 
errors + label + sequence + date of 
graduation + retirement date + system 
+ utility + description + partition 
disk(s) + saveset(s)/source(s) 


id(s) + type + errors + date of 
errors + label + sequence + percent 


_used + date created + retirement date 


+ SYSEem + Ucillity = decéeri ec ommee 
OWNGE + aqdVisor + Contact pmone 
partition/disk(s) + saveset(s)/ 
source(s) 
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Function: 


Read Tape to Disk 


Mini-specification E 


Edit: Read Tape 
to Disk 


Query Backup/ 


Vendor Tapes 


Select Backup 
Tape (s) 


Get Tape(s) 


Select Equipment 


Perform Read 
Return Tape(s) 


Update TLS 


Data Items E 


General Backup 
Description 


Approximate Tape 


Vendor 


Periodic 


Inga vidue i 


Requestor would like a vendor or 
backup tape read to disk. 


Query the library with as much 
information as the requestor can 
provide concerning the tape. 


Select from the database listing 
the exact tapes needed to perform 
the read. 
Retrieve tape(s) with the id 
numbers selected. 


Select the equipment defined in 
the database. 


If the physicals information 
provided by the utility regarding 
the tape is’ different than that 
in the library data, update. 


(Some or 
+ System 
+ vendor 


all) type + date created 
+ name of owner + software 


(Some or all) Varies according to 
oe. 
(Type = vendor) + system + software 


+ vendor 


(Type = daily, weekly, monthly, or 
graduation) + date + system + 
partition/disk 

(Type = staff, faculty, student) 


+ SYSEEM + vowner 


Tape List 


Vendor 


Periodic 


Padividual 


Equipment 
File Path 
Errors 


Error Record 


Varies according to type backup: 


i1d(s) + density + loan + errors + 
label(s) + sequence + date received + 
Votre et rinny eteoese hi DE1TON + 
owner + contact phone + software + 
vendor + partition/disk + saveset(s) / 
source(s) 


id(s) + (type = daily, weekly, 
Nove Vor craduar lone) m+ errors + 
label + sequence + date + system + 
VEIT tye desermpelon + partition/ 
disk + saveset(s)/source(s) 


id(s) + (type = staff, faculty, 
student) + density + loan, errors + 
label(s) + sequence + percent used + 
date + system + utility + owner + 
advisor (if student) + contact phone 
+ “deseripemen + pareition(s)/disk(s) 
+ saveset(s)/source(s) 


system + utility + density 
partition/disk + saveset/source 
errors + date of errors 


id + error update 
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manct] Om: 


hoan Tapes 


Mini-specification F 


i Edit: Request 
Borrow Tape(s) 


ee meuery for 


Tape(s) Requested 


a select Tape(s) 
to Lend 


ls Get Tape(s) 
om Add (Loan 


Information) 
zo TLS 


Data Items 


General Backup 
Description 


Approximate Key 


Vendor 


Periodic 


Paaividual 


Tape List 


Vendor 


CO 


Fe 


If requested by anyone but a 
librarian to remove a tape(s) 
from the library. Type tape must 
be  Vendon, Inaividual, staff, 
student, faculty. Permission 
from the owner should be obtained 
before lending. 


Query database for id of tape(s) 
requested. 


Select ids of requested tape(s) 
from database listing. 


Retrieve tape(s) with the id 
numbers selected. 


Update the library to contain 
information regarding the loan. 


(Some or all) type + date created 
+ system + name of owner + software 
+ vendor 


(semen eOrsalljs Varies according to 
Ey Pe 


(Type = vendor) + system + software 
+ vendor 


(Type = daily, weekly, monthly, or 
graduation) + date + system + 
pater ie bom, cars i 


Hivsee-sotatt, taculty, student) 
SS eS Se Tehiialena 


Vette omacecemarmma FOG type backup: 
ft et ecenc tins t loan + errors + 


label(s) + sequence + date received + 
System + utility + description + owner 


Pemaeqdic 


badividual 


Loan Agreement 


Record of Loan 


+ contact phone + software + vendor + 
partition/disk + saveset(s) /source(s) 


id(s) + (type = daily, -weekly, 
monthly, or graduation) + errors a 
label(s) + Sequence + date + system + 
utility + description + partitiony@ea. 
+ saveset(s)/source(s) 


id(s) + (type = staff, faculty, 
student) + density + loan, errors + 
label(s) + sequence + percent used + 
date + system + utility + owner + 
advisor (if student) + contact phenom. 
description + partltiion(s) /disk (ee 
saveset(s) /source(s) 


loan + date loaned + estimated date of 
return + loanee + loanee's contact 
phone ; 


id + loan agreement 
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Figure 


Bie, 


Function: Returned Loaned Tapes 


Mini~specification G 


Airs EGite wa ReELUEnIng 
Borrowed Tape(s) 


ae Query Loaned 
Tape (s) 

oe Verify Correct 
Tape (s) 

ee Replace Tape(s) 


Bs Delete Loan 


Data Items G 
Tape 
Loaned Tape List 


Updated Record(s) 


The requestor (loanee) returns 
tape(s) borrowed from the 
library. 


Query the library to find which 
tapes are held by the loanee. 


Verify the returned tape(s) 


belonging to the library, that 
all are present, etc. 


Delete the record(s) of the loan 
from the library data. 


= tape + id 
= loanee + id(s) 


= id + (loan = no) + (delete 
record of loan) 
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Function: Delete Tapes (erase backup or trash 
physical tape) 


Mini-specification H 


bg Fdit: Request to 
Delete Backup 
or Tape(s) 


ve Query for Tape(s) 


oe Select Tape(s) 


4. Get Tape(s) 


oe Delete Records 


Data Items i 
General Backup 
Description 


Approximate Key 


Vendor 


Valid wie. 


Any type tape is first copied to 
another tape and then logged into 
thes | itera. 


Daily, weekly, monthly, or 
graduation backup = retirement 
date <= current date. 


Vendor or individual staff, 
faculty, student = owner = 
requestor. : 


Query library for a listing of 
tape(s) which satisfy the 
requestors description of the 
tape(s). | 


Select the id(s) of the tape(s) 
desired for deletion. 


Included only if trashing 
tape(s). 


Delete records to reflect the 
erasure of backup or the trashing 
of a physical tape 


(Some or all) type + date created + 
system + name of owner + software + 
vendor 


(Some or all) Varies according to 
eysoer 


(Type = vendor) + system + software 
+ vendor 
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Periodic = (Type = daily, weekly, monthly, or 
graduation) + date + system + 


partition/disk 
Individual = (Type = staff, faculty, student) + 
system + owner 
Expired Retirement = Requirement date <= today's date 
Date 
Tape List = Varies according to type backup: 
Vendor = id(s) + density + loan + errors + 


label(s) + sequence + date received 
+ system + utility + description + 
owner + contact phone + software + 
vendor + partitioin(s)/disk(s) + 
saveset(s) /source(s) 


Periodic = id(s) + (type = daily, weekly, 
monthly, or graduation) + errors + 
label(s) + sequence + date + system 
at ine seriptlOn + partition/ 
disk + saveset(s)/source(s) 


Pedividual seetovcue te Gyeer—= Start, faculty, 
Student) + density + loan, errors + 
label(s) + sequence + percent used + 
date + system + utility + owner + 
advisor (if student) + contact phone 
_ dese alpenener soartition(s)/disk(s) 
+ saveset(s)/source(s) 


ids 
New Record: 


If to Delete 
Tape Data 


If to Trash 
Tape 


ids 


(type = scratch) delete backup 
record 


(type = empty) delete physical 
and backup record 
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C. “DPD DATA DiICTRlOGNARY 


Advisor 
Contact Phone 


Date of Errors 


Date of Graduation 


Date Loaned 


Date Receivec 


pensity 


Description 


Disk 


ELeeors 


Estimated Date of 
Return 


Identification 
Number (id) 


The name of a student's advisor 
The phone number of the owner 


The date the errors were provided by 
the utility 


The graduation date of the students 
whose files are contained in a 
graduation backup tajpe 


The date a tape is loaned 


The date the tape was received by the 
library 


The bits per inch which may be read to 
tape 


Notes by the librarian regarding the 
software 


Used with the VMS operating system to 
define a major subdivision of files of 
disk 


The number of "bad bits" on a physical 
tape. The figure is provided by the 
utility when a tape is read or written 


The date the librarian assigns as the 
date the tape should be returned to the 
TP prar y 


A unique number assigned a slot in the 
cabinet. Slots are numbered consecu- 
tively left to right, top to bottom. 
the number may be used to locate the 
Slot. When a tape is logged into the 
library it is assigned the identifi- 
cation number of the slot in which it 
VS “Seered. 
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Label 


Length 


Loaned 


Loanee 


Loanee Contact 
Phone 


Owner 


Pareltion 


Percent Used 


Retirement Date 


Saveset 


Software 


Source 


system 


ype 


The VMS operating system requires that 
each tape be assigned a "label" by the 
librarian. When the tape is mounted, 
the label verifies to the system that 
the tape is VMS. If the "copy" utility 
1s used to read or write the tape, the 
label must be entered by the librarian 
when mounting the tape. 


The total length of a reel of tape 


Whether or not the tape is loaned from 
the library 


The person to whom the tape is loaned 


The phone number of the loanee 


The name of the owner of the tape 


Used by the UNIX operating systems to 
define a major subdivision of files 


The percent of the tape containing 
backup data 


The date the librarian assigns to the 
tape for retirement 


Used with the VMS "backup" utility to 
mark the beginning of each file or set 
of files 


The name of the software on the tape 


Used with other than VMS operating 

Sy scopic sassdemup: or “copy” utili- 
ties to describe a file or set of files 
ONwar eae 


The combination hardware and operating 
System by which the tape data may be 
read or written 


The use of a tape maintained by the 
Li Dreamy 
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Type Daily 


Type Graduation 


Type Individual 


Type Monthly 


Type Scratch 


Type Vendor 


Type Weekly 


Wiea Weicey, 


Vendor 


Disks are read to tape each day. These 
daily tapes are written to one set of 
tapes each week and identified as a 
daily backup 


A backup tape containing disk files of 
Students of a graduated class 


The type tape is an individual staff, 
faculty, or student's backup tape 


Each month, all disks are read to tape 
and identified as monthly backups 


Blank tapes assigned to slots in the 
library available to read data from 
disk 


Tapes containing vendor software 


Each week, all disks are read to tape 
and identified as a weekly backup 


The software utility which must be used 
to read or write the tape data 


The name of the company which produced 
the software 
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Iti. LOGICAL SCHEMA 


A. BACHMAN DIAGRAM 


ACTIVE 


| TAPE 
LOAN 
STUDENT 


PmmeorhCIFICATION DATA DICTIONARY 





DESCRIPTION 





Mvenwopecification Data Dictionary defines the entities 
S@emcata elements in the tape library. It groups each of the 
Sepemeeeemonts under tne entity to which it is logically 
related. The definitions describe the meaning and use of the 
entities and elements in the library. The Specification Data 


Dictionary is provided in Appendix A. 


IV. DESIGN 


In this chapter the design of the TLS is described in 
detail. First the logic of the design is discussed. Tt 286 
followed by a description of the tables. A chart of the 
application module and a description of each frame is. pro- 
vided. The modules association with the functions described 
by the DFDs are provided by charts. Integrity, security, 
the database administrator, and validation and test are dis- 
cussed. The design data dictionary and frames definition are 
derived from this chapter and are provided in Appendices C 


and D for ease in future reference. 


A. LOGIC OF THE BESIGN 
Several factors were considered before mapping the logi- 
cal schema to the Ingres database. They were prioritized as 
follows: 
User 
Interactive standardization and validation of ings 
Simp hel cy 
Diptera iante rane © tons 


Ingres 
Database requirements 
Query by forms (QBF) limitations 
Report by forms (REF) “i lextowiia, 
Applications by forms (ABF) capabilities 


Logical Schema 


48 


1. User 

Non—ctandard ~record input, incorrect data input, and 
Seiad bility to control the sequential consecutive assignment 
of identification (id) numbers are the major problems in the 
current library system. An interactive forms-basec input 
method with validation capabilities can correct these prob- 
lems. The TLS must be kept simple and quick to facilitate 
the task of logging tapes and retrieving data. 

2. Ingres 

Ingres is a relational DBMS. It provices a means to 
store data in tables. The basic methoc for entering, re- 
memeving, and manipulating data is by use of its data manip- 
Peereron language, "QUZL". The user of QUEL must nee Sean 
the language commands and syntax, and the structure and con- 
tent of each table. Data manipulation with QUEL 1s too time 
Bemeouming and distracting for the daily functions of the li- 
brarians. However, Ingres provides Query By Forms (QBF), . an 
automated forms processing interface, which simplifies data 
manipulation. The user may interactively aprend, delete, 
replace, or retrieve data from one table at a time ir the 
Maeaoase without knowledge of QUEI.. 

QOBF provices an automated methoa for the functions cf 
eppend, query, update, and deletion of values of records of 
One table at a time. Jt presents forms to the user which 
feet L1iel?cs “from the appropriate table. By default, UeF 


Meee meo ail Or the taplie s fielcas to the user. The forgs 


Ay 


may be edited by the application developer by using the 
Visual Forms Editor (VIFRED) to limit the data the user can 
INPUE SOR eManu pu late. The editing capabilities include the 
deletion or addition of fields in a form, detinition Of meas 
parameters, and definition of field attributes for valida- 
tion, mandatory input, error messages, automatic repetition 
of field values, and special display modes. 

QBF requires different user procedures for each of 
its functions. The Append function must be used for initial 
SNtry Of a Ypecord: The Append function has an autcmatec 
Facility which simplifies the sequential Frou of Yrecore. 
which nave many fields of equal value. After the first 
record is entered, the user may duplicate the field valmoamume 
Subsequent records by pressing a function key. This simpli- 
fies input and can be used to remind the user of the previcus 
value input. 

The Update function must be used in QBF to replace or 
delete values in existing records. When using Update, the 
First display of fields is presented for the user tc Gua: 
tne record or records desired. after the query is entered, 
Ingres retrieves the records and displays them cn the ter- 
minal, one at a time, for update. Update does not have the 
SOC at POM t GUAR ts. 

Four limitations cf GBF greatly affected design sam 
ne automatic field value duplication facility may be usec im 


Nee | Gy ero > I ee : ae P= Zs oo a iL , 
Pepencd. Oly? 2) When more than one rpeecord 16 tei — 


fu 
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eave an the Update function, they appear on the terminal one 
feet ime. This format is not useful for reports or records; 
3) QOBF only allows manipulation of data on one table at a 
memes and 4) OBF does not provide for any internal mani- 
pulation and assignment of data values. 

Report By Forms (RBF) is a forms-based record speci- 
fier available for retrieving reports without knowledge of 
QUEI. RBF allows the developer to select, design, and 
present multiple record reports from one table at a time, 
through the use of views. RBF's facility to present reports 
with data from multiple tables greatly eitmnsed the design 
Meee application. 

The developer may integrate the functions and forms 
of OBF and RBF into a Single application by using Ingres 
Applications By Forms (ABF). The application uses forms ag 
the vehicle for interaction between the application and user. 
The user uses menus to select operations desired and forms to 
append, query, or update, or to retrieve reports from the 
database. Knowledge of QUEL is not required. ABF allows eric 
MeveloOrer greater flexibility than the functions available in 
Memeand REF. RBF, however, was sufficient for the library in 
certain cases, whereas QOBF was not. In most cases, it was 
GmpOssibdle to match a task with only one table. In OQEF, one 
task would have required the librarian to remember to adc 
new values to several tables. To maintain data integrity, 


1t would be unwise to leave this responsibility te the 


Imjibrar lane Additionally, the assignment of id numbers 
required control to prevent duplication and ensure consceem. 
tive, sequential numbers. This required a search of current 
id numbers, a possible arithmetic operation on the maximum id 
and assignment of the result to the form. ABF enables such 
flexibility by allowing development and integration of proce- 
dures into the application by the developer. The procedures 
may be used with forms developed by the use of VIFRED. The 
forms have the same capabilities as those described above. 
ABF will be discussed further in Section D. 
3. Logical Schema 
a. Data Class ilAre 

The data class TAPE was mapped intact to table 
TAPE in the logical schema. The fields values in table TAPE 
provide physical tape characteristics which retain @eg@eues 
importance throughout the life of the tape's existence in the 
library whether or not any data on the tape is of importance 
GOowtne Iterary.2 

The TAPE table stores all of the id numbers 
assigned in the library. As discussed above, aéedcnneme eng 
tapes to id numbers, and the addition of new 1¢€S toe 
library are controlled by the application. Gne librarian | 
typically enter the values (id, length, and bpi) of the TAPE. 
recora when adding new blank tapes or new vendor tapes to the 
library. Such tapes will have the same values for length and 


Ya wm, 9 pate = me Ae i BS : : i eee 
Opl. anererore, tne task is greatly facilitaved by Brevi ae 


the field attribute of repeating values to the form defini- 
ron . Data integrity and future retrieval is assured by 
meng Validation criteria into the form definition. wO 
fields, errors and date of errors, are entered and maintained 
by the librarian at other times - after the tape is reac or 
Piet ten. As a separate task, the record is updated. After 
an active tape is retired, but the physical tape is retained 
by the library for rewrite, all of the values in TAPE are 
retained. If the tape is thrown away, all of the values of 
TAPE are updated to null except the id number which is re- 
tained. Such an id number is known as an Sie ELlOe and will 
be used by the application for future assignment to a new 
scratch or vendor tape. 
PeeeDatea Classe sh 

Data class SET must be related to TAPE so that 
the id number in SET allows tne librarian to access the phy- 
Sical characteristics in TAPE when a tape is to be read or 
written. 

The key to data class SET 1s long and variabie 
Meeording to its type act We tape. Therefore, field id was 
Memea to SET. SijiGCem—eatcd Ci cigomereliVE TAPE Values are 
entered and deleted at the same time as SET, and since ACTIVE 
Meee is logically closely related to SET, it is contained 
With data class SET, ina table named SETS. New records are 
Meeec tO SETS at the time a backup is read, or when a new 


vendor tape is input. As discussed above, when new vendor 


oe 
OP) 


tapes are added, SETS values are appended to the SETS table 
by the avo ltcation. 

The timing for entering backup tape datas 
different. In order to read a backup to tape, the librarian 
must first find an appropriate scratch tape in table TAuus 
New records are added to table SETS using QBF-append. As 
each record is added for each id, common values (those of 
data class SET) are automatically called to the form after 
the first entry. Only the fields expected to be dittemere 
for each id (those of data class ACTIVE TAPES) will be 
entered by the librarian. If the librarian Noses track “Ges 
which id was previously entered, (s)he may use the function 
key to recall it. 

CGC.) Pata Class ele ean, 

Data class FILE PATH is contained in taple Pius 
There are many file paths on one active tape or one file path 
on several tapes of one set. 

Fach FILE PATH record must be linked to an vm 
number so the librarian can locate the particular tape id(s) 
on which the aie path was located. Therefore, id was added 
to table TAPE. File records are usually added at the same 
time new SETS records are added, i.e., when a new vendor tape 
1s received or when a new backup is read. In this case, new 
FILE records are added using the QOBF-append function. Since 
one id may have many FILE records; or one FIL second am 


—_ 
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wave many 14S, no repeatiry valves are defined a i eis imenc 
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mera attributes. The librarian may repeat values by using 
the function key. The only exception to the time of entry of 
FILE PATH discussed above is on the infrequent occassion when 
the librarian adds a new file path to an individual's old 
tape. This task requires fields from two tables to ce 
Siemged — FILE and SETS. in this case, a separate procedure 
is provided in the application to ensure the integrity of 
both tables. 
eee Wata Class STUDENT 

Data class STUDENT is contained in table STUDENT. 
New records are added to STUDENT each time a new graduation 
Matekup 1S added to SETS. Eventually, the librarian must find 
on which tapes student files are contained by student name. 
Therefore, id was added to STUDENT. New records are added 
uSing QBF-append. A student may have files on many tapes. 
Data class STUDENT fields are, therefore, repeated by the 
Bemm arter the first entry. 

e. Data Class LOAN 

Data class LOAN is included in table LOAN. Since 
tapes are added to table LOAN on an individual basis as fre- 
quently as they are by SETS, id was added to the table. LOAN 
records are added when a tape is loaned using the QBF-appenc. 


They are deleted when a tape is returned. 


ope. 


B. TABLES AND ViIEWs 

Initial input of library data are stored in the hash 
storage structure in which records are stored randomly; new 
rows are added to the bottom. Therefore, the entire table 
must be scanned for retrieval. The majority of retrievals 
and comparisons in the library involve selection of records 
based on id number. Hash tables store each row at an address 
determined by a column or columns ina record. Records may 
be located directly by the value of the address, without 
scanning the entire table. The hash storage structure can 
greatly excellerate queries run on tables with a large numper 
of rows. After the current library 1S input, it is Heee7. 
mended that all tables be converted to the "hash" Storage 
Structure [Refs. 1 and 2], using the id number as the 
"address" column. Thereafter, the hash structure shoulcwie 
modified when 20 percent of the table is changed. The tables 


and views are contained in Appendix B. 


TABLES ' VIEWS 
file vind 
loan vioan 
sets vpe 
student vretire 
tape vscloan 


VSCraten 
vstudent 


SeeeeDEoLGN DATA DICTIONARY 

The Specification Data Dictionary (Appendix A) defines 
fields in terms of how they are used in the library. The 
Design Data Dictionary (Appendix C) defines fields in terms 
of how they are used in the TLS application. Both should be 


read for full comprehension of the field's use. 


eee Loe APPLICATION 

The tape library was developed using Ingres Application 
By Forms (ABF), and is an interactive application with a 
forms interface. The application user interacts with the 
meme OY filling in fields with data. The application inter- 
faces with the form by getting. values from it, and sometimes 
placing values on it. 

ABF applications are built by the use of frames. The 
frame is the principal vehicle for interaction between the 
user and the forms application. Each full screen the user 
sees 1s a frame. A frame is composed of a form and a= pro- 
cedure. The upper portion of the frame is the form. 

The developér designs the form. Leama verinclude trim 
and/or fields. When defining a form the developer only 
includes the fields which may be manipulated by the frame. 
Fields and their attributes are included in the form defi- 
mrtilon. Retoisurces sane@liude validation criteria, validation 
failure messages, and value "display only", and mandatory 


input requirements. 


Below the form on the lower left of the frame 1s a 
command menu defined and placed on the frame by the proce- 
dure. The menu includes a list of operations which the user 
may select. By selecting a command, another procedure is 
called to execute the operation. The library application 
commands include procedures for movement to other frames, 
input or retrieval of data, and a few arithmetic operations. 

Frames may be designated as one of four types or usages 


by the developer. Three are used in the library - QBF, RBF, 


and User Specified (User). 

(1) QBF - When encountering a QBF-defined frame, ABF calls 
on the QOBF subsystem. QBF allows append, query, and 
update operations to be performed on one table of the 
database. The developer may limit which of these 
Operations may be performed by the frame when defining 
the frame. A form and one table are associated with a 
OBF frame. The procedure is automatically provided by 
OBE. 


(7) Report Writer - When encountering a "report"-defined 
frame in the library, ABF calls on the Ingres RBF sub- 
system. Reports and optional forms are associated 


With report frames. By defining the report, the 
developer controls the output mode format and report 
inclusion ‘and? baveuc- The developer may provide a 
form in the frame definition. The form allows’ the 


user flexibility in ‘report retrieval. The Uscwaims 
select records by field values or ranges. 


(3) User - When ABF encounters a user-specified frame, it 
calls on procedures written by the developer. Pro- 
cedures and forms are associated with user frames. In 
the library, procedures are written in either the ABF 
Operations Specification Language Code (OSL) or in a 
combination "C" language and QUEL. OSL simply calls 
other frames or procedures, or exits from the appli- 


cation. "C" and QUEL were used where such a program 
would be more efficient, simpler, or more secure than 
QBF, or where an operation required data input to or 


retrieval. from more than ome tool 


Pee RAMES 

The frames of the tape library are provided as charts in 
Pieoendix OD. They are defined briefly in the frame descrip- 
mom section below. The frames, and their associated forms, 
procedures, reports, and tables are listed and defined in 


greater detail in Appendix E. 


fee RAMES DESCRIPTION 
aes Topframe (1) 
Topframe (1) is a user frame which provides a menu 
LSpaiele mae form spells out the commands available in the 
operations menu. The user may select one of six operations 
which call the OSL procedure. The first five call another 
frame - TQuery/Report (1.1), PQuery/Report (1.2), Add (1.3), 
Update (1.4), and Delete (ie Seeetine last, Exzt, ends the 
melication. 
meee tOuery/Report (1.1) 
PQuery (1.1) and all of its subordinate frames. pro- 
Vide either a path to retrieval, or retrieval of a report 
from the database to the terminal. Terminal reports were 
designed for use by the librarian to search the database for 
a particular tape or set of tapes. The fields, formats, and 


sorting was selected for easy reference and relevance to the 


librarian. PQuery is a User frame which provides a menu 
moom . The form defines the commands avallable on the oper- 
ations menu. The user may select one of nine operations 


Ne, 


which call the OSL procedure. The first eight call another 
frame ~- Scratch (1.1.1), Periodic (dab, wh, mb; gb) (77 eee 
Incivicdual Mais. 1b, “uy (1.1.3), Vendor (1.1.4),  StUiame 
(1.1.5), Loaned (1.1.6), and Date to Retire (1.12.7) ee 
selecting Return, the OSL calls Topframe (1). EX1t leaves 
the application. 

(1) Scratch (1.1.1), Periodic (1.1.2), Individual (ae 
Vendor (1.1.4), “Studene (1.1.5), Backup or  Vemeien 
(1.1.6.2), and Date to Retire (1.1]1./7). Fach of eae] 
frames are report frames which display a parameter 
form. The form includes fields in which the user must 
enter data to define records to be included in the 
report. RBF provides three commands at the bottom of 
the form, Help, Report, and End. Help provides ie 
user with assistance. Report enters the parameters 
and causes the appropriate data to be 1listed. End 
returns to the previous frame. The fields and field 
attributes of each form and the report definitions are 
provided in Appendix E under the appropriate frame 
definition. 

(<2) Loaned (1.1.6) is a User frame which provides a menu 
COR. Tne form lists four commands available on the 
operations menu. The user may select one of the 
Operations to call an OSL procedure. The First eae 


Call another frame - Scratch (1.1.6.1) ana Eackur wee 


60 


Vendor memes. 0.6 2) Return calls the previous frame 
TQuery/Report (1.1). Exit terminates the application. 
Mmemeeoctraten (1.1.6.1) is a report frame which has no asso- 
clated form for parameter selection. RBF presents 4 
command menu with the commands Help, Report, and End. 
Help provides assistance to the user. Report causes 
the loaned scratch tape report to be listed on the 
terminal. End calls the previous frame - Lcaned 
(1.1.6). The report fields and format are describea 

in Appendix E under the appropriate frame definition. 

Bee POuery/Report (1.2) . 

Pemery/Report (1.2), and all of its subordinate 
frames, provide either a path to retrieval, or “retrieve a 
report from the database to a file in the librarian's per- 
sonal UNIX workspace. The librarian may then print the file 
using the UNIX operating system. The primary reason for pro- 
viding printed reports (except in the case of dump reports) 
was to provide a means for the librarian to communicate with 
Mi@erary users. Therefore, the fields, format, and sorting 
was selected to group data ina format relevant to users. 
Dump reports were designed to provide the librarian with a 
printed list of each relation in a format which would facil- 
itate comparisons between relations. All printec reports 
were designed to conserve paper. Ingres documentation de- 
memroes a method for printing reports directly from AB. 


HOwever, Enis Metnod Goes not work because cf a coding errcr 


o>) 
-~ 


in all of the current Ingres versions. It€ will be “correctea 

in the upcoming Version III. Therefore, this slightly more 

cumbersome method of "write to file" was used. TQuery 1S a 

User frame which provides a menu form. The form spellsvous 

the operations available on the command menu. The user may 

select one of nine operations which call the OSL procedure. 

The first nine call another frame - Scratch (1.2.1), Periodic 

(1.2.2), Individual (1.2.3), Vendor (1.2.4), Seudentey. a 

Loaned (1.2.6), Date to Retire (1.2.7), Dump (1.2.8). " Reteamae 
calls the previous frame. Exit terminates the applicatiGims 

‘Ge Scratch (1.2.1)7 Berivcaic Fie CTE RES| (1.225 

Venecor (l<224), Stvuéeent (1.2.5), Backups or Veiga 

(1.2.6.2), and Date to Retire (7.2 sae Fach of these 

frames are report frames which display a parameter 

form. The form includes fields in which the user must 

enter data to define the records to be included in the 

report. It also provides the name of the output files 

to the user. RBF provides three commands at the 

bottom of the form - Help, Report, and End. Helowaaes 


vides assistance to the user. Report enters the par- 


ameters, selects data, and writes the report to yaa 
End returns to the previous frame - PQuery/Report 
(Ola es The reports definitions are provided iam 


Appendix E. 


(2) Loanec (1.2.6) is a User frame which provices a “heme 


~~ 


2oOrm which writes out the operations available on the 


~~ 


i) 


SOuMchnemmeomae sine £Lirst two —call the OSL to call 


Paw woeEd@Pemmm lt. 2.6.)) Or Backup or Vendor (1.2.6.2). 


Return returns to the previous frame - PQuery/Report 


fhieeieew Exit terminates the application. 

Sesacemm |L.2.6.1) 18 a report frame which provides a 
form that communicates the name of the output file of 
the report to the user. RBF provides three operations 
on the command menu - Help, Report, Return. Help pro- 
vides assistance to the user. Report writes a report 
en SGbateh tapes sto Ehemoutpute file. End returns to 
the previous frame - Loaned (1.2.6) 

Dump (1.2.8) 1s a User frame which provides a menu 
form which writes out the operations included in the 
command menu. The first six call frames - Tape 
ee ee eee Cin | 2S 7 ee ee 1228.4 )e Student 
ieee 5.4); and Ween (i.2538.5)5 Return calls POuery/ 
Bepeorte(l.2). ExXitte terminates the application. 

ene meio oS . 1p Serbs 1322852); File Gare =o = 3); 
See evenoe 4) enG. Lodieet(i.2.8.5)..are report 
frames which provide the name of the output file te 
the user. RBF provides the operations on the commana 
menu - Help, Report, and Return. Help provides 
assistance to the user. Report selects, sorts, and 
writes the report to file. Return calls the pre- 
vious frame - Dump (1.2.8). The report definitions 


are included in Appendix EF. 


4, Add (1.3) 

Add (1.3), and all the frames subordinate to it; ene- 
vide the means or a path to a means for the librarian to add 
a new record to a table or to more than one table of tne 
database. Add is a User frame which provides a menu form 
that defines the operations available on the command menu. 
The user may select one of seven operations. All call the 
OSL to call a frame - Scratch (1.3.1), Vendor (1-3-2) ) eae 
(lasso) > Fables (1334) Sw eoeldehues Ck ooo jak Oan (1 .33rogee 
Return Calls the previous frame 72400 eee 

(1) Seratch (1.3.1) isa User framemy a eieee coe and three 

procedures. The form provides fields for data @aneu- 
into one table. The first procedure is an OSL pro- 
cedure which provides a command menu at the bottom of 
the. form of three operations - Id, Add, and Return. 
By selecting Id, the OSL calls on procedute sGemiae 
The purpose of sgetid (and vgetid (1.3.2)) is +0 Jen= 
sure empty slots of the library are filled and wei. 
new lds assigned are the maximum id plus one. New ids 
are assigned to the database only when scratch tapes 
or vendor tapes are added. Sgetid id (like vgetieui. 
in frame 1.3.2) assigns the id labels to tapesueem 
tapes and slots and informs the librarian of “the Wom. 
OLN Tew wei. sgetid places the id on the form and 
prompts the user to enter new data and select Add. By 


selecting Add, the OSL calls procedure ascratccie wae 


CY) 


updates the fields of an empty slot record in the TAPE 
table or appends a new record to the TAPE table if the 
entered data meets the procedure and form validation 


@riLteria. it Informs the user of the action taken and 


what labelling action the librarian should take. By 
selecting Return, the previous frame - Add (1.3) is 
called. 


Pemaeor (ile.2) 1S a user frame with a form and ~three 
procedures. The fo0mum provides fields for data input 
to two tables. The first procedure iS an OSL pro- 
cedure which provides a command menu at Pie bobeon) OL 
the form which includes three operations - Id, Add, 
and Return. By selecting Id, the OSL calls on proce- 
Gure vgetid which retrieves the lowest empty slot, or 
ie Veeicmenumber stroma the database and puts it on the 
form. It tells the user if the id is that of an empty 
slot or a new id and prompts the user to enter the 
new input and select Add. By selecting Add, the OSL 
calls procedure avendorc which enters the new data 
on the two tables if it meets the field ee ee and 
tne procedure's validation criteria. The prccedure 
Peempts Ehe usen tovanform him or her of action taken. 
By selecting Return the previous frame - Add (].3) is 
Gailed. 

Backup (1.323) 1s a User frame which provides a menu 


form which writes out the operations provided by the 


Or 
(Nn 


OSL procedure. The OSL procedure provides a command 


menu of three operations on the bottom of the form 


which call other frames - Periodic (1.3.3.1), Indivi- 
dual (1.3.3.2), and Return to the previous frame —- sae 
(elec oP 


Periodic (1.3.3.1), Sets (1.3.3.2), New  Backiig@ouueem 
Vendor (files) (1.3.4.1), Students (1.3.5), andeeeay 
(1.3.6), are QBF-append only frames. Each frame pro- 
vides a form for data input. QBF provides a command 
menu at the bottom of the form which includes three 
operations - Help, Add, and Return. “Help provides 
assistance to the user in the use of QBF. Add appends 
the data to the appropriate table. Return returns to 
the previous frame. 

Files (1.3.4) is a User frame which provides a menu 
form which writes out the operations provided by the 
OSL in the command menu. The OSL provides three 
operations which call frames - Periodic (1.373503 
iia duet (1.3.3.2). Return calls the previous (frag 
= (ae Vfl S Sales 

Old Partial Individual (1.3.4.2) is a User fErameu see 
a form and two procedures. The form provides fields 
and validation criteria for data input ta” two. tas lea 


The OSL procedure provides three og¢eérations on “Hme 


form's command menu. Add calls procedure adfoled whies 
appends a record to the file table and  Gaedates "Fhe 


sets table. Return calls the previous frame - Files 
(oes. 4 ewe Px EeCrminates the application. 
Bee Update (1.4) 

Update (1.4), and the frames subordinate to it, allow 
the librarian to update selected information in the database. 
The data may require update because the values changed since 
they were entered or because they were entered incorrectly. 
Update is a User frame with a menu form and an OSL procedure. 
Tne form writes out the four operations provided by the CSL 
Memene COmmand menu. The first four call the OSL to call 
Seer frames - Errors (1.4.1), Backup (1.4.2), and Loan 


(1.4.3). Return calls the previous frame - Topframe (1). 


Peaeers wie. 1) Backup (1.4.2), and Loan (1.4. 


tad 


) ales 
CBF update only frames. Each has one form which provides 
selected fields which enable update of one table by the 
imeorarian. OBF provides the command line which prompts the 
user for query of the old record, then update. 

6. Delete (1.5) 

Delete (1.5) is the only frame which allows deleticn 
of records from the database tables. Delete is a User frame 
with a form and four procedures; tdelete.osl, dloanc, dbackc, 
and dtapec. The form provides a field and lists the oper- 
ations in tne command menu provided by the OSL procedure. The 
user enters into the field the id number of the tape for 


which records will be deleted. The OSL procedure prov 


vn 
ot Noah 


Ei, 


Meee Operations On the Command menu. Loan calls precedure 


bey 


dloanc which deletes records from the LOAN table. Backup 
calls procedure dbackc which deletes records from the SETS, 
STUDENT, and FILE tables. Tape calls procedure dtapec which 
deletes records from the SETS, FILE, STUDENT, and LOAN Gage 
and all fields from the TAPE table except id. The id number 


in the TAPE table will then be an empty slot. 


G. DFDS/FRAMES 
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Ee INTEGRITY 
Database integrity is maintained in seven ways. 
(1) Permits are defined to allow only the Jibrariancueeee 


perform any functlons On fhe Cobteo or Sener 


—, 
NO 
~——" 


All but two fields are limited to only one table. Tie 
exceptions are id, which is used as the ink) betwee 


Lables; and) Conte = Contph is in SETS ard STUDEN ae 


7) 


The student record is created when the student gradu- 
ates. At that time, all of their files are written to 
Emenagt@aalatlon backup, including any individual stu- 
dent backups they may have owned. All SET records 
regarding the student are deleted at this time (in- 
eluding the SET contph). Therefore when the student's 
Sento number is entered to STUDENT, it no longer is 
recorded in SET. 

Data 1S validated upon input. Where allowed values 
were limited and known not to change frequently, ee 
dations were defined in forms. They are listed in 
Mependix E. 

"Repeat previous valve facility". Librarians have 
many other duties which may distract them while enter- 
m7gqeddta Om a form. To remind them of their previous 
Peay weney May Simply press a function key for a dis- 
play of previous fields entered when using QOBF-append. 
Programming. To ensure the consecutive, sequential 
assignment of ids to cabinet spaces and new tapes, the 
assignment iS pep sO nMed byrne alplication. 

Update. Values which change in the course of time, or 
values which have no validation on input may be up- 
dated by the librarian by using the update frames. 

The dump reports provide listings of all tables sorted 
by id number. The librarian mey use these to compare 


the values recorded for each id number in each table. 


ie “st Curia 

As discussed in Section H, only personnel to whom pemmmmee 
have been granted may affect the tables of the database: 
Only the librarians are assigned permits. Any additional 
security measure is login symbols. Login symbols provide 
access to the application. 

A login symbol is defined in the login files of each of 
the librarians to grant them access to the TLS. No one else 


may gain access. 


us DATABASE ADMINISTRA tO 
The database administrator will perform the following 
FUNCELONS to Magmtain "Ene Vise 


(1) Implementation - instructions for implementation are 
provided An Appendix Ges 


(a) Load the Current Wileiwany recouce 
(ob) Change the storage structure of all tables 


(23 Maintenance = InStEructions for Maahecenance 68 wre 
library are included in the tutorial im Append 


(a) To maintain peak performance, system modifica- 
tions must be run on each table when 20 percent 
of the records in the table have been changed. 
Monthly system modifications are recommended in 
iGo me a blic@ne gislibes 


(Oo) Maintain the integrity of the library by destroy- 
ing and defining permits to tables as personnel 
are relieved of their librarian duties and new 
librarians are assigned. 


(Cc) Define the TLS login symbol in the login fEileswew 
new librarians assigned. Delete the login sign 
from the login files of personnel relieved of 
librarian duties. 


Ke VALIDATION AND TEST 

Frames were developed in a top-down fashion, Topframe 
and each of the menu frames first. Append frames were then 
developed and tested. Records of 34 tapes, backup data, and 
associated data, were entered into the library using the new 
frames. The update frames were then tested. The librarian 
verified the functionality of the frames and appropriateness 
of the fields. The terminal report frames were then develop- 
ed and tested followed by the printed report frames. The 
Meeeertan verified the reports’ inclusion and format. All 
frames were tested together using the small, representative 
library data and a scenario of the various processes per- 
formed in the library. | 

Various bugs in the Ingres DBMS were discovered during 
testing: 

(1) The Ingres documentation does not describe how to 
select records from one table which are not in another 
table. This was resolved by an Ingres representative. 

(2) The VM UNIX Version 2.1/15VE.04 interface between ABF 
and OBF malfunctions. A corrected version has been 
Bea to NPGS. 


(a) In OBF-update mode, updates were not performed. 


(b) In QOBF ~ all modes, validations could not be cer- 
formed between sets. 


(3) The Ingres documentation does not cescribe hcew to 
interface parameter forms with RBF reports. An Ingres 
representative explained the procedure. 


fees Known buG exiSts in the RBF facility. The documen- 
Paetonmeceserires Row ©o Elag ingress to output repcrts 
Perec ly ©6 a Pprinter. The process is cod 
rectly and will not be corrected until the next 


version of Ingres, Version III is developed. There- 
fore, the TLS outputs reports tov se printed sre.) =e 


user's UNIX workspace. The report must then be 
Printed Erom UNIX: 


V. RECOMMENDATIONS AND CONCLUSIONS 


Recommendations regarding the use of the TLS, observa- 
meems. cregarding Ingres, and an opinion on use of the 


requirements analysis and design process are presented. 


Peel HE LIBRARY 

The tape library system (TLS) is designed to enable the 
Computer Science Department to provide secure, dependable 
library services. They may do so by implementing the TLS 
Seecribec in this thesis, and by locking the cabinets in 
which they keep the tapes. There are ways, however, in which 
data can be entered incorrectly. They exist because: 1) 
either there is no means of validating the entry; 2) the 
likelihood of making the error can be reduced by methods 
Meer than validation; or 3) the potential error is not 
critical or can be easily recognized and corrected by the 
librarian. 

(1) Ingres forms allow validations which refer to other 
fields in the same or other tables. However, these 
values are recorded for comparison at the time the 
form iS initialized. Forms are initialized when CBF 
is called. Therefore, when adding records to ae set, 
the values added after CBF was called will not be 


included in the validation. ieapies Swhitcn cet new 


~J 
Cd 


tJ 


values through QBF-append (SETS, FILE, LOAN, STUDENT) 

are vulnerable £o Ehis | Backer orm va lidaeronn Double 

entries of id numbers or entry of id numbers which are 
not logged in the library can occur. This likeWiiiges 
is kept low because of the two procedures provided in 

a. and bh. below. If either error occurs, it may be 

Caught and corrected.) a ee 

(a) In order to write a backup the librarian must get 
a scratch tape and an id number. They must be 
found in the scratch tape list, there is no other 
place to find available tapes or id numbers. The 
scratch tape list is created and maintained by 
the application and has very tight “integrity. 

(ob) If the librarian is entering records into the 
tables, and forgets the last id number entered, a 
control function may be used to see which was the 
last id number entered. 

(co) If an id is listed in SETS, FILES, STUDEN? =o. 
LOAN which was not assigned in the library or 
which duplicated a previously assigned number it 
will be discovered when a routine backup or 
vendor report is run, or when the librarian runs 
a dump of the table. 

Librarians occassionally enter the wrong dates, espe- 
Cially the year. Ingres does not allow arithmetic 
operations on dates in QBF validation. Therefore, the 
application will not validate date input. However, 
current date entry errors are quickly discovered “Gz; 
che" ibieary. In the TLS they may be corrected using 
the update frames. 


When reports are retrieved by selecting parameters by 


Value, the value must be exact (or * for all or eae 


~J 


Teeter eananyewona). Upper case letters are consider- 
ed different than lower case. It is recommended that 
all entries be in lower case letters and that the li- 
brarians standardize input as recommended in the data 
dictionaries (Appendices A and C). Where likely dis- 
crepancies occur, the * symbol may be used within a 
word to mean “any letters," or by itself to mean "any 


malue. “ 


meee LNGRES 

Various other strengths and weaknesses of Ingres were 
learned during the study. 

migres promotes the use of OBF, RBF, and ABF in its docu- 
mentation. RBF and ABF are efficient and comprehensive for 
use for the tape library and much more complicated applica- 
tions; QBF is not. When a OBF form is called from ABF, at 
least 15 seconds pass before a form appears on the screen. 
This time, and the limitations on validations available, are 
burdensome to the user. Input time is faster than it weuld 
be by use of a procedure, but for simple appends and updates, 


it dosen't save enough time to compensate. REF takes as long 


BeemProauuce a report, which is acceptable considering the data 


retrieval, selection, and sorting process involved. ABF is a 
powerful and convenient tool for building and testing 
applications. 


Ingres documentation is incomplete. AS 


D> ote 
fA 
(ft 
O 
C, 
ep) 
Cp) 
M 
- 
| 

J 


ies 


Chapter IV, certain procedures were omitted. 

Various bugs were revealed in Ingres. This was the 
developers first intimate experience with a commercial soft- 
ware product. This experience and discussions with more 
experienced developers indicates software, at any price, is 
always in the test and development stages. It 1s recommended 
that the CS staff maintain close liaison with the helpful 
hotline at RTI to improve the NPGS purchase and the RTI 


PHOguet, 


Cs REGULREMENTS ANALYSDS Ne ves rey " 

A requirements analysis and design process similar to 
those described by Kroenke [Ref. 3] and DeMarco [Ref. 4] was 
implemented. Although there were times when it seemed the 
process was in the way of progress, it was followed dili- 
gently. As has been written by Boehm [Ref. 5], and many 
others, time consuming requirements result in fewer surprises 
during the design process. By the time the design stage was 
started, both the library and Ingres were well known. "Gia 
Ingres bugs or deficient documentation caused surprises 


curing design and implementation. 
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APPENDIX A 


SPECIFICATION DATA DICTIONARY 


meee DATA CLASS: SLOT (included in Tapes) * 


Definition A slot in a tape cabinet. Only one tape is 
stored ina slot. Each slot in a cabinet is 
identified and labelled with an identification 
number. Slots are labelled consecutively left 
Eon Lit, MOS ©O lO Lon 


Elements 

Seemeification A unique number assigned to a aoe 
Attribute nels * 

Type Type 1S an attribute of tape. Therefore, if 


no tape is assigned to a slot, the TAPE 
table will have a null entry in all tape 
attributes except "id". 


feral) attributes other than "id" in table TAPE have null 
values, the record represents an empty slot. If the id 
and any other attributes in table TAPE have values, the 
slot id number is the same as the tape id number. 


ee Key 


va 


B. DATA CLASS: 


Definition 


Elements 


Tdentif£ication 


Attribute 
Constraint 


Length 


AGEri bute 
Constraint 


Density 


Avie ubpuke 
COnStraint 


Paerors 


Attribute 
Daberer (Errors 


Pio lipuie 


TAPE 


A 7/9 track reel of magnetic tape up to 3600 
feet long, to be used or being used to store 
data useful to the CS department. Attribute 
values impact the librarian's decision of 
whether or not to use the tape for a specific 
"read to tape” request. 


A unique identifier of a tape. The same as 
the identification number of the slot to 
which it is assigned 


id 
unique, key, mandatory 


The length of the tape. Tapes are normally 
300, 350,400, 450, 550, 3600, 63507 a 
2400, Or 3600 feet long 


lengeEn 
mandatory 


The bits per inch the tape may copy. Densi- 
ties are 800, 1600, 6250,a combination 160g 
6250, or 10,000. Combinations shal ene 
recorded as 6250 


bpi 
mandatory 


The number of bad bits on the tape. The 
utility provides the number when a tape is 
read or written. Used to determine the 
condition of the tape: 1 Sven ene 
librarian will run it again when the heads 
are freshly changed to get a more accurate 
reading. If the figure remains greater than 
10, it is considered unacceptable to use to 
read certain types of backups. 


err 
The date the errors were last checked 


derr 


See DATA CLASS: SET 


DPellnition A conceptual entity which is one or more tapes 
of recorded data (may be called an active tape) 
which, together, are identified as a whole. 


Elements 
Type The category of the active tape(s) by virtue 
of what is recorded on it. Types are: 
daily system backup (db) 
weekly system backup (wb) 
monthly system backup (mb) 
graduated student's backup (gb) 
individually owned-staff (is) 
Pidryraual lywewned=faculty backup (1f) 
individually owned-student backup (iu) 
vendor software (v) 
Attribute type 
Constraints key, mandatory 
Poa veonmem cane muse = Gb, woh, mb, gb, is, 
ie per Ole Vi 
System A code representing a combination hardware 
and operating system from which the tape was 
read. Current codes are: 
neigh scald2 
ees 2 sunl 
microvaxl sun2 
microvax2 ex): 
pdpl vmsl 
papZ vms2 
sea dul 
Attribute system 
Constraints key, mandatory 
wertlity The software utility which was, and must be 


used to read or write the set of tapes. 
Utilities currently used by the department 


are: 
/ingres {ASIC 
/npsSuserl /visl 
/npsSuser2 /vmsSsys 
/npsSuser3 [work 
/user 


We 


AECETbure 
Constraints 


Density 


ReEer lou ee 
Constraints 


Date Created 


Attribute 
Constraints 


Retirement 
Date 


Attribute 
Constraines 


Description 


Att EPoUutS 
CONnStrarpes 


We tei, 
mandatory 


See "Data Class. Lace. 


jeyonl 
must be the same value as Data Class: TAPE 


The date the first bit of the active set was 
read to tape. Used to determine the age of 
the bits and the period of time the tape 
represents. The date to be recorded varies 
according to the type of the set. 


dcreate 
key, mandatory 
value for each tape is limited to: 


dbo Wb> Mb, sults er Ue a caie 
read to tape 

gb the date the class graduated 

v = the first day of the month the 
tape was received by the owner 
or department 


The date the active set should be converted 
EOuSCratehs (In the case of individual 
sets, the owner's permission must be obtain- 
ed before conversion.) Varying according to 
Eyles 


dretire 
mandatory 
value for each type limited to: 


db = dcreate + 1 month 
wo = dcreate + 3 months 
mb = dcreate + 6 months 
gb = dcreate + 2 years 
v = dcreate + 5 years 
1s = dcreate + 2 years 
1f = dcreate + 2 years 
iu = dcreate + 2 years 


Narrative comments about the set 


descr 
none 
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Name of Owner 


Metribute 
Constraints 


Pavyisor 


Attribute 
Constraints 


Contact Phone 


Attributes 
Constraints 


Software 


Attribute 
Constraints 


Vendor 


metry ibute 
@enstraints 


The name of the owner of the tape(s). Used 
only in individual or vendor set types. 


owner. 
is, if, 1u = mandatory and key 
Vv = optiional 

oye wor MO, Go, = mult 


The name of the student's advisor. Used 
only in individual student set type. 


advisor 
lee —= Optlena | 
dieaywoh> MD, GD, 1S, .l1t, v = null 


A phone number. Only used in individual or 
vendor set types. The person whose number 
1s recorded varies according to set type. 


Selpgieloiat 
is, if, v = owner's phone number 
iu = advisor's phone number 


ite sianememeiie Somtware om the tape, 
including the version number. Only used 
for set type vendor 


software 
v = mandatory, key 
dil = WOG ins Gb 1S sale, eu = null 


The name of the vendor company which pro- 
duced the software. Used only for set 
type vendor 


vendor 


Vv = optional 
oye aioe GD elmore f= nul) 


e1 


D. DATA CLASS 


Deina Wacom 


Element 


Identification 


AGE Duce 
Conserealnt 


Label 


Attribute 
Constraint 


sequence 


Attribute 
Constraint 


Percent Used 


Attribute 
Const rearnc 


; ACTIVE TARE 


A conceptual entity which is one tape which, by 
Virtue of its recorded data 1S a member of a 
set. Attributes are dependent upon the fact it 
has recorded data and is a member of an active 
set. 


A unique identifier of a reel, the same as 
the identification number of the slot to 
which it is assigned 


Ae 
unique, key, mandatory 


The VMS operating system requires that each 
tape be assigned a label by the librarian. 
When the tape is mounted, the label verifies 
to the system that the tape is for VMS read/ 
write. If the “copy” utility as useauee 
read or write the tape, a label must be 
entered by the librarian when mounting the 
tape. It is not necessary for the librarian 
to know the label name when using the other 
VMS utility-"“backup". The librarian ehe@seawa 
label name which indicates what is recorded 
on the tape. 


label 
iba? ibe ct Ieaies4 copy) mandatory 
if (utility = backup) optional 


The sequential order of the tape in the 
total number of tapes which make up the set 


seq 
if number of tapes in the parent set > l, 
then mandatory 


The percent of the tape which contained. 
Data used for tapes which are members of set 
type individual only; and only tape is 
partially used. 


perusd 


lf (iS. 1£, 10) and partially used ene 
optional 
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Be DATA CLASS: 


Wish ers keel 


Beenition A conceptual entity which provides the path to 
the disk location of one or more files. Inher- 
ent in the file path name construed by the 
fronearian asethe file “content. 


Elements 


Partition 


Attribute 
Monstraint 


Disk 


Paetribute 
Constraint 


Saveset 


Attribute 
@onstraint 


Source 


Attribute 
Constraint 


A major subdivision of files in the UNIX 
operating system. The partition from which 
the files were read 


Part 
if system UNIX* then mandatory, key 
if system = UNIX* then null 


A major subdivision by disk in the VMS oper- 
ating system. The disk from which the files 
are read 


disk 
if system = VMS* then mandatory, key 
1f system = UNIX** then null 


When using VMS "backup" utility, marks the 
beginning of each file or set of files. Ter- 
minates with an end-of-file marker. When 
Hsing them oacKkUe. smelt bity fOr read/write, 
the saveset must be entered by the librarian 
in order to mount the tape. Librarians 
assign saveset names which indicate what is 
im thee tae 


Sav 
1f utility = backup then mandatory, key 


Systems other than VMS and utilities other 
Ean DaechmOmand copy de NOt require the 
assignment of label or saveset names. The 
lisa lamer ads COMEnITyea a source’ to be 
assigned to a file or set of files on a tare 
which 1s read by other than VMS backup and 
copy utilities. The assigned name indicates 
the file(s) contents 


Sire 
igi eee ky, 


backvipmek Copy and 
set type gb, then mandatory 

ee teat ly ery, packupuen copy and 
set type = gb, then optional 


H 
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FE, “DATACLASS: 


Description 


Elements 
Name 


Retr louce 
Constraint 


AGV1ISOLr 


Attribute 
Constraint 


Contact Phone 


Attribute 


Ge. SDATASCiRSo. 


Definition 


Element 

Loanee 
Attribute 
Constraint 

Date Loaned 


Attribute 
Constraint 


Estimated Date 
Of Return 


Meicigale eae 
COnSEratiit 


Contact Phone 


Attribute 
Constraint 


STUDENT 


The name given to a person who has graduated 
from NPGS and whose files are contained in a 
set of graduation tapes 


The last and first name of the student 


name 
required key 


The name of the student's advisor 


advisor 
mandatory 


The telephone number of the advisor 


= 


contph 


LOAN 


A conceptual entity which describes the 
agreement under which a tape is loaned. 


The name of the person to whom the tape was 
loaned 


loanto 
mandatory key 


The date the tape is loaned 


dloan 
none 


The date the tape should be returned to the 
the library — 


edr 
edr > dloan 


The phone number of the loanee 


lemieor 
none 
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Pee LABLES (Ref. 4] 


File, Loan, Sets, 


Table: 

Owner: 

Row Width: 

Saved Until: 
Number of Rows: 
Number of Pages: 


Journaling: 
Beotage Structure: 
Table Type: 

column name type 
Ue ii 
Bey Src G 


Table: 

Owner: 

Row Width: 

Saved Until: 
Number of Rows: 
Number of Pages: 


Memrnaling: 
Seorage Structure: 
Table Type: 

column name type 
isl a 
edr date 
fentph e 


Pee 2 Xaee 


TABLES AND VIEWS 


File 


crawford 


26 


Student, 


Tape 


11-Jan-1999 00:00:00 


21 
i 


disabled 


heap 


user table 


length 


Loan 


Crawlora 


52 


2 
es 


column name 


part disk 
err 


11-Jan-1999 00:00:00 


SB 
JL 


disabled 


heap 


user table 


length 


2 
ie 
iFAE 
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column name 


dloan 


Toone © 


type 


length 


length 


he 
Cr 


Table: 

Owner: 

Row Width: 

Saved Until: 
Number of Rows: 
Number of Pages: 
Journaling: 
Seoucdce soOerPUCLUBC: 
Table Type: 


column name 


ct 
KK 
O 

om 


id 
dcreate 
system 
owner 
Concpn 
vendor 
descr 
perusd 


8) 
ct 
ay 


OO Gl iGO: 


Table: 

Owner: 

Row Width: 

Saved Until: 
Number of Rows: 
Number of Pages: 


VOUBNadatia:: 
SEOragGe Seructure: 
Table Type: 

column name type 
1d al 
advisor é 


Sets 
crawford 
LS 
t=—Jan-199930 0-00-00 
eZ 


iL 

disabled 
heap 

user table 


length column name 
2 type 
Ate dretire 
9 Utd ae, 
9 advisor 
4 software 
Zo label 
is: sequ 
a 
Student 
crawford 
30 


11-Jan-1999 00:00:00 
4 
i 
disabled 
heap 
user table 


length column name 
2 name 
9 COMerh 


8 6 


type 


Cc 
& 


length 


Table: 

Owner: 

Row Width: 

Saved Until: 
Number of Rows: 
Number of Pages: 
Journaling: 
Peerage Structure; 
Table Type: 


column name type 
id a 
bpl i 
derr 


B. VIEWS 


wand, 
vven 


vloan, 


vpe, 


ieee 
crawford 
19 
11-Jan-1999 00:00:00 
18 
1 
disabled 
heap 
user table 


length column name 


ey ale 


2 length a 
2 err aL 


vretire, vscloan, vscratch, vstudent, 


length 


VIEW 


range of t is 
range of s is 
range of f is 
define view vi 
pe. Sts 
type = 
owner 
adviso 
COMP pl 
dcreat 
system 
We dele 
bpi = 
label 
jase (6 
Sav Sr 
descr 
err = 
length 
perusa 
sequ = 
where 
and 
and 


VIND DEFINED 


tape 
sets 
file 
quer 

5 ale 
s.type, 
= s.owner, 
iC Sec Se i 

= s.contph 
e = s.dcreate, 

= s.system, 
Veceoule lity, 
jaeeayoney 

=S2 lapel, 

isk = f.part disk, 
Seo eeesav sre, 

= s.descr, 

t.err, 

meee ngeh , 

See aasa, 
Seo) 
Gs Soicl ae 
(ees. = (Ss 
(s.type = 


nm iw ll 


faac) 
id) 
on) 


e/ 


VIEW VLOAN DEFINED 


range of t is tape 
range of s is sets 
range of 1 is loan 
define view vloan ( 


ia = tec 

type = sS.ctype, 
system = s.system, 
eequ = s.sequ, 
owner = S.owner, 
software = s.software, 
dloany— | 2dtean- 
loanto = 1. boantee, 
lentph = 1. lengea, 
edr = l.edr) 

where (t.id = s.id) 
and (l.id. = Se7ard) 


VIEW VPE DEFINED 


range of s is sets 

range of t is tape 

range of f is file 

define view vpe ( 
Pa == Sena 
type = s.type, 
dcreate = s.dcreate, 
system = s.systemn, 
Utility sss edie 
Dpl =) eebear, 
label = s.label, 
pares disks 2: pasemciak) 


SAV SrCG = £JSavesee, 
descr = s.descr, 

err. = £.Erene, 

sequ = s.sequ) 

where (t.id = s.1d) 
and (Se1d.= £.2d) 
and (s.type = "*b") 
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VIEW VRETIRE DEFINED 


range of t is tape 

range of s is sets 

define view vretire ( 
dretire = s.dretire, 
type = s.type, 
dcreate = s.dcreate, 
SYStem = S.System, 
sequ = s.sequ, 
Clip sy 5 oly 
length = t.length, 
oy oin Weal ait ay eal 
err = tegerr) 
where (tela = S.id) 


VIEW VSCLOAN DEFINED 


range of t is tape 
range of s is sets 
range of 1 is loan 
define view vscloan ( 


el, = lave 

ecm =—i,ear, 

dloan = i.dloan, 

loanto = 1].loanto, 

ikevmisisigl 2 ie soimeeyel: 

where (t.bpi != Q) 

and (t~.length != Q) 

and (any (sed byt sid 
where (tJideu=—eseala) ) =e) 
and Guereicie ll avok 


VIEW VSCRATCH, DEP INED 


range of t 1s tape 

range of s 1s sets 

define view vscratch /( 
GS. bee 
length =s22Geng the 
bpi =Seebpu 


err = t.err, 

derr = t.derr) 

where (t.length != Q) 

and (enveloeta Dyvete1d 
Whewmem (tem So a)7 = 0) 
and (Gow CO) 
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VIEW VSTUDENT DEFINED 


range of t is tape 

range of s is sets 

range of rv2 is student 

range of f is file 

define view vstudent ( 
mame = rv2.name, 
dcreate = s.dcreate, 
id = ssc 
system = s.system, 
utLIIty = "segeriacy, 
bp = CJ beae 
label = s.label, 
part disk = f.part disk, 


sav sre = f£.sav src, 
Geser —eoamaesers 

sequ = s.sequ, 

a€adViSOr = EVZ-adviscon, 
CONtph =" (CrV2econtp ma) 
where (f.idejervy2..c 
and (S...16 Go a) 
and (eid: -as. 1G) 
and (s.type = "gb") 


VIEW VVEN DEFINED 


range of t is tape 
range of s is sets 
range Ober se niwe 
define view vven ( 

Lasser 


software = s.software, 
vendor = s.vendor, 
SYSUTGM] = S2S7s com, 


Utility =ss20t ila 

Dbpis =e eae, 

label = s.label, 

Part disk — f > parmcrcwsic, 


SaV SiC [si ssavy-re, 
descr = s.descr, 
owner = s.owner, 
advisor = s.advisor 
CONtLph = S2eeneon 
Grr =) Ulcers, 

sequ = s.sequ) 

where (seich=]=s7 -14G) 
and (ta oS 5 ae 
and (Ss type = <"v2) 
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APPENDIX C 


DESIGN DATA DICTIONARY 


In Appendix A, the parameters of integers and floating 
point numbers were expressed in bytes, as Ingres does. The 
parameters of these data types are expressed in bits. Read 
weeeas "integer, two digits." Read f1.1as "one digit 
decimal one digit." 

Field: advisor 
Name: advisor 


Data Class: 
Definition: 
Parameters: 


Constraints: 


Where Used: 


ereorage: 
View: 


set 
The name of the student's advisor. 


c9 


TIME Sie SLigete beet |) 
no spaces or commas. 


First eight letters of last name, 
of first name; 


Seurce input. Table Frame 
sets eee cS =o 2 
student Le re, 

Maintenance: Table Frame oe On 
sets 1.4.2 update 
student 1e5 delete 
sets Pe delete 

Other: ieee ee les 5. of 2 3 
ee eee ee a Oe, 6 268. 4 

sets, student 

vstudent 


oH 


Field: 
Name: 
Data Class: 
Definition: 


Parameters: 


COnStraints: 


Where Used: 


ScOlage: 
View: 


bpi 
density 
tape 


The bits per inch capacity of the tape. 


14 

Valid values: [200 7ere0G> 6250, 10-000) 

Mandatory 

SOurce meu: Table Frame 
tape Ms: Dives Lee elie, See 

Maintenance: Table Frame Action 
tape ie delete 

Other: Tots lel ee, ek eee ele eee 
Lido p Le peel ca, Pipe 
le2e3> Lecae ys des ole 
live 2 Oueel 

Cape 

vind, vpe, vretire, vscratch, vstudent, vven 


LO 
NO 


Field: 
Name: 
Data Class: 


Definition: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
View: 


Gemepn 
Contact phone 
set 


If field advisor = null then the phone number 
of the owner 

If field advisor != null then the phone number 
of the advisor 


14 


Last four digits of the telephone number 
Mandatory 


Source sinput: Table Frame 
sets eee Wl et Sey 
student ier ec pas. 

Maintenance: Table Frame — he tron 
sets er update 
student ee delete 

Other: [Pee ore Peeler, Sele > ee 1 2 aS, 
(er lee eee 2, Lae oS 4 

sets 


Vistudent Vind 


28: 


Field: 
Name: 
Data Class: 


Def diniitcdeem.: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
View: 


dcreate 
date created 
set 


If type = db, wb, mb, 1s, if, 1u then the dane 
the backup was created 

If type = gb then the date the class graduated 

If type = v then the date the tape was received 
by NPGS 


Co 
mm/dd/yr (last two digits) 
Mandatory 
SOure] Enpuc: Table Frame 
sets L342. eS eee 
deo sue 
Maintenance: Table Frame Action 
re a2 update 
es delete 
Other: Lodes2,. Lolwas [asec ieee 
Le2Ze2dy Lele). 12205 lee 
sets 


Vind, vpe, vretire, vstudent 


Field: 
Name: 

Data Class: 
Definition: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
View: 


derr 


date of errors 


tape 


The date the errors were last checked. 


c8 


mm/dd/yr (last two digits) 


Souree Inputs 


Maintenance: 


Other: 


Cape 
vscratch 


Table Frame 
tape ace 

eae Frame jeje aliopel 
tape eid s al update 
tape dlighe. delete 


IG sl MEG ay Aes cee tl 


25 


Field: 
Name: 

Data Class: 
Definition: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
View: 


desc 


description 

set 

Librarian's notes about the 

ells 

none 

SOurece winpus- Table 
sets 

Maintenance: Table 

Other: ee eee. see ee 
Ie 2 veces 
Pen oe 

sets 

vind, vpe, vstudent, vven 
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set. 

Frame 

P3425. Lesa 
Ce ree 

Frame Action 
need ee update 
Jens delete 
, tei.4, 1 alee 

, La2e4, lege 


Field: 
Name: 
Data Class: 
Definition: 


Parameters: 


Monstraints: 


Where Used: 


peorage: 
Views: 


dloan 
date loaned 
loan 


The date a tape is loaned. 


c8 

mm/dd/yr (last two digits) 

Mandatory 

SOUrecewInput: Table Eeame 
loan eee) 

Maintenance: eS NS heane lore aLeyal 

1D delete 

Other: WeuOrole wee eeroraZ als 26 41, 
Neen pls 26 Os S 

loan 


vloan, vscloan 


oy 


Field: 
Name: 
Data Class: 


Definition: 


Parameters: 


Constraints: 


Where Used: 


torage: 
View: 


dretire 
retirement date 
set 


If type = db, wh, mb, 9b, 1s, 25f, 10, therein 
date the backup should be converted to 
SeGraten 

If type = v then the date the vendor tape 
should be replaced due to old bit age 

If type = is, if, iu, then permission must be 
obtained from the owner before conversion 

Recommended values by type: 


db = dcreate + 1 month 
wb = dcreate + 3 months 
mb = dcreate + 6 months 
gb = dcreate + 2 years 
v = dcreate + 5 years 
is, if, iu = dcreate + 2 years 
c8 
Mandatory 
Source InpyVeE: Table Module 
sets 1.3427 )..3.35e0e 
Ne eae 
Maintenance: Table Module ACtlon 
rac ane update 
Was delete 
Other: Leds Je Ie Zee on Siero 
sets 
vretire 


oles) 


Field: 
Name: 
Data Class: 


Merynition: 


Parameters: 


@eonstraints: 


Where Used: 


storage: 
View: 


edr 
estimated date of return 
loan 


The date the librarian assigns for a loaned 
tape to be returned to the library. 


ors! 


Wi ae, yo {last two Gigits} 


Seoumee Input: Table Frame 
Poan a5 42,6 
Maintenance: Table Frame Ae tiLon 
eGneed update 
(ieee Gelete 
Other: (ewes cl) eee 1. 2 Ge 
Mae 0.5 


loan 
vloan, vscloan 


oh, 


Fields: 
Name: 
Data Class: 
Definition: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
View: 


err 
errors 
tape 


The number Of badwe2 es sone 


eZ 


Toe 


Sources Inpuc: 


Maintenance: 


Other: 


tape 
vind, 


vpe, 


eape. 
Table Frame 
tape a oo)! 
Table Frame Action 
tape dee Aue: update 
tape leas) delete 
Lelcl >) Lele eee alee 
4147, lize wee eee 
Vee 4% L227 eee 

vretire, vscratch, vven 


EO 


Field: 
Name: 
Data Class: 


eranition: 


Parameters: 


Constraints: 


Where Used: 


SLorage : 
Views: 


id 
ldenti£fication 
Cape 


The unigue number assigned to all cabinet slots 
and tapes; key to all tables. 


oS 

1-10000 

Mandatory input in all tables 

source Input: Table Frame 
tape IES Cele Rs eo 
sets tie oeemle, 3a 2 
file oreo le, ls Suadie 2 
student pga ee 
loan ees ess: 

Maintenance: Table Frame None sUS\ial 
sets eS delete 
file Hees delete 
student Jas: delete 
loan ie delete 

Gener: Peierls Jal. 4, 
fewer ewieo eh, Ve to622,° lel. 7; 
ieee el 2 eo, le 2s 4, 
irene ere, V2 O42, 1. 27, 
ioc eee eo, Le2s8s3, 
ice eo, Lodel, 1.4.2, 
wg ae 

tape, sets, file, student, loan 

Vinci a vilGahwn Vioe, Vvseikibae, = vseclOan, vSCratch, 

vstudent, vven 


OL 


Field: 
Name: 
Data Class: 


Definition: 


Parameters: 


Constraints: 


Where Used: 


SeOraqe. 
Views: 


label 
label 
active tape 


Reguired by the VMS operating system. 
The name of a tape, assigned by the librarian. 


cé 


1f system = VMS then Mandatory 


Source “put: Table Frame 
sets beoeZ, lessor 
d Bae RG ee 
Maintenance: Table Frame ACt en 
Ves delete 
Other: lials2, lee So ei eae 
le2ze2, Lé2e4oe lee 


Sets 
vind, vpe, vstudent, vven 


Field: 
Name: 
Data Class: 


Description: 


Parameters: 


memstraints: 


Where Used: 


SEOLrage;: 
Views: 


Iie jo) al 
loanee contact phone 
loan 


Phone number of the person to whom a tape is 
loaned. 


ron bil 


Three numbers of area code, space, seven 
numbers of phone number (no hyphen) 
Mandatory 


Seumeeceinput: Table Frame 
loan MOEN Siero 
Maintenance: Table Frame Action 
Ree update 
Brae delete 
Other: eG lies hg Oe ge Le 2 6 Oe > 
. divereeOreree he 2s. 8s. S 
loan 


vloan, vscloan 
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Field: 
Name: 

Data Class: 
Define fom. 


Parameters: 


Constraints; 


Where Used: 


storage: 
Views: 


length 

length 

tape 

The length in feet of a magnetic tape. 
i4 


Valid Value: [(300,)5400 3450, S55, 600, 16s¢7 
12007324007 or 2600) 





Mandatory 
SOURCE LHput: ale he Peame 
tape eer 
Maintenance: Table Brame Actions 
Bee) se delete 
Other: Lelily, LileS jl oe 
Pe2e3y7 142573 ,7- eco 
tape 


vind, vretire, vscratch 
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Field: 
Name 
Data Class: 


Derinition: 


Parameters: 


Constraints: 


Where Used: 


SeoLage : 
Views: 


ioan FO 
loanee 
loan 


The name of the person to whom a tape is 
loaned. 


ells 


Last name, comma, as much of first name that 
wo lee a t 


Mandatory 
poumee Input: Aveta es INTIS) 
loan dO 
Maintenance: aves) Ns Frame Action 
‘ay ee update 
seas" delete 
Other: mena eel Oo. 2 eel. 2. 6. 1, 
ee Oa 2 ee Gs 
loan 


vloan, vscloan 


Or 


Field: 
Name: 
Data Class: 


Det idmi.e ten: 


Parameters: 


COMmStraints: 


Where Used: 


Storage: 
View: 


name 
name 
student 


The name of a student who has graduated from 
NPGS and whose files are maintained on a 
graduation backup tape. 


Gi 


Last name, comma, as much of first name that 
Wig labee  e 


Mandatory 
SOutee Input: dkeved tS gee 

student eae ors, 
Maintenance: eo Resome Action 

Is delete 

Other: 1.1.5, Lo2< Sy lee 
student 
vstudent 
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Field: 
Name: 

Data Class: 
Hetinition: 


Parameters: 


Constraints: 


Where Used: 


Storage: 
Views: 


owner 
owner 
set 


The name of owner of the data on the tape. 


eo 
First eight letters of first name, first 
initial of last name; no spaces or commas 
Mandatory if type = individual 
peurce Input: Table Frame 
sets ree 70 ev oeey 3s 2 
Maintenance: Table Frame AC Elon 
eis 2 update 
i=" delete 
Other: eee auremie. Of) De 2 ay 
Meee oe O 2 Bee oS 
sets 
vind, vloan, vven 


Loe. 


Field: 
Name: 
Data Class: 


Description: 


Parameters: 
Constraints: 


Where Used: 


Seo welge. 
Views: 


jeslisis Shue 
Pabevt1 On Of la malk 
file path 


Partition is a major subdivision of files in 
the UNIX operating system. Disk is a major 
subdivision of files by disk in the VMS 
operating system. 


c9J 
Mandatory 
SOURCE Input; Table Frame 
file ease ee 13 ale 
deers eae ae, 
Maintenance Table Frame AGtier 
Es delete 
Other: fel.2, lel 3) tee lee 
Llezgded; 12203, 12224032 
1 eZee. 38 
file 


vind, vpe, vstudent, vven 
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Field: 
Name: 
Data Class: 


weoetm1 tion: 


Parameters: 


Senmstraints: 


Where Used 


Storage: 
View: 


perusd 
percent used 
active tape 


If type = is, if, or iu then the percent used 
of the last tape of a sequence of tapes which 
make up a set. Use only if percent is less 
ian 00". 


mez 
bos) 
Seunee Input: pia e Eee! 
sets mores Seg eras 4s 2 
Maintenance: Laale Frame Action 
iS delete 
Other: een owls. 2 «Somme 2. Oc 2 
sets 
vind 


meh, 


Field: 
Name: 
Data Class: 


Definvelon: 


Parameters: 


Constraints: 


Where Used: 


BEOLrage: 
Views: 


Sav_sre 
Savset or source 
file path 


If VMS backup utility then marker for beginning 
of each set of files. 

If not VMS backup utility, then librarians wae 
of a set of files 





els 
Mandatory 
SOuUnCe Input; Table Frame 
file lee Bai oe hee See 
Pes ee, 
Maintenance: Table Frame ACtTem 
lees delete 
Other: Lads 2, Lelas |. dae eee 
Lle2eZd, 1.223, ee lee 
Leo 
file 


vind, vpe, vstudent, vven 


Field: 
Name ; 
Mata Class: 


Definition: 


Parameters: 


fmonmstraints: 


Where Used: 


storage: 
Views: 


sequ 
sequence 
active tape 


The sequential number of a tape in the total 
number of tapes which make up a set (read "1.4" 
asmeone Of Four”). 


fle 


Express as sequence number decimal point total 
number (e.g. 1.4) 


SOum@ec .INput: Table Frame 
sets UE Se Poa (me es eras ee 
Maintenance: Table Frame AGieLlon 
ea 2 update 
Pe: delete 
Other: ieee lS el 4 yp. Ladoeds 
ee Oe lle» Ie? 22° 12 oe 
ee eee Oe 2 Ls 2 fe 
de Dee pelea ae 
sets 


vind, vloan, vpe, vretire, vstudent, vven 


Ibe tb 


Field: 
Name: 

Data Class: 
Definition: 


Parameters: 


Constraints: 


Where Used: 


SL@erage: 
Views: 


software 
software 
sets 


The name of the software of a vendor tape. 


crs 


Include version number after name. 


If the name 


is too long leave off enough letters to include 
version number as last entry. 


Mandatory 


[Our ce Inputs 


Maintenance: 


Other: 


sets 
vloan, vven 


Table 
sets 


Table 


eZ 


Frame 


WeZzod, 


Actitem 


delete 


1. 24 Oem 


Field: 
Name: 

Data Class: 
Berinition: 


Parameters: 


Constraints: 


Where Used: 


storage: 
Views: 


system 
system 
set 


Combination hardware and operating system code. 


c9 


Valid Values: 


Mandatory 


SDOUBeos In Dut: 


Maintenance: 


Other: 


sets 
Vanco | Oan, 


vpe, 


jie eS | 
Peas Z 
microvaxl 
microvax2 
igvonmns 
nbi2 


Table 


sets 


dels 


vretire, 


ilodes 
nbi4 
Misacs 
nbi6é 
gis aoe! 
nbi8 


vstudent, 


pdpl 
pdp2 
alae <1! 
vmsl 
vms2 


Vvyeon 


Field: 
Name: 
Data Class: 


Definition: 


Parameter: 


COnNStralmes: 


Where Used: 


Steragqe: 
Views: 


type 
type 
set 


The category of active tape 


is recorded ont e- 


eZ. 
db, wo, MD; Gb7 ts 7et tru 
Mandatory 
Source Input: Table 
Sets 
Maintenance: Table 
Other: Boe ee ae ee Le 
Were ¢. bs os 
lige? Oras 
sets 
vind, vloan, vpe, vretire 


Frame 


1.3.2 
Ilys 48 


by virtue of what 


pee oo cle 


2 
ACtie@m 


delete 


Field: 
Name: 
Data Class: 


Menrrmition: 


Parameters: 


Constraints: 


Where Used: 


storage: 
Views: 


Ute dell ey, 
Gheau. hia 
set 


The software utility used to read or write the 
backup or vendor tape. 


/ingres 
/npssuserl 
/npsSuser2 
cé 


Mandatory 


SOUnGe. FnpUuUt ¢ 


Maintenance: 


Other: 


sets 


vind, vpe, vstudent, 


/npssuser3 


Pause 


Table 


sets 


LAS 


Vvetl 


(USES 


PeVsi 


/vmsSsys 
,WOrK 


AGtaon 


delete 


ete: Sir 
eee) > 


jp au= lk~el= 
Name: 

Data Class: 
DeGiniition: 
Parameter: 


Constraines: 


Where Used: 


Storage: 
View: 


vendor 
vendor 
set 


The name of the vendor of a vendor tape. 


EZe 
Mandatory 
source Input: enone) Frame 
sets ie aw 
Maintenance: Table se\uls ACtiem 
1S delete 
Other: Dickea4 iy 1) 202 eee eee 
Sens 
vven 


TG 


2021S IBID IB, 





FRAMES 


even 








sO aue1Ndo} 


JHNO IIOHG 

awe mdo) WHO 4 
49Ssn IOVSN 
aweydoy  IWrH) 


awesdoy NNW 











f9tt 


UAOIA 710v1 
uesop) LHOdIH uROJISA WA 
yurop WHO4 yoez9sup Odd 
wode: INVSN euoUu WHO 
ueop =o IWVH4 poder = 39Vvsn 
JOPUBA yoa1es9Su| WH} 
so dnyoeg ONIW YIIBINS fIN IW 
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Asenb) WHO 4 

aesn WNvSN 

Asanb) WYH 4 


yiodey 
Ai9NOL ON IW 
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gaz eezt 
vueoIP ree mwIno i1vepNitp 

ven Vittws MeEpPNHye 

wen, THOWwdy WepNIS 

Ueno] wns iepnis 
ode: JOwsSA wodes 

uray werd Wwepnie 

veo} ON 1 lwepnis 


RZ 


j80 Guinpd 
IHN IO He 


duinpd WHO ¢ 

aso TNvSi 
dwopd wevHs 
duing ON 
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IHOd 7H 
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Errors 
errors 
QBF-update 
errors 

tape 


MENU 
FRAME: 
USAGE: 
FORM 


Update 
update 
user 

update 


PROCEDURE. 


update.os| 


Backup 
ubackup 
QBF-update 
ubackup 
sets 


zee 


Loan 

uloan 
QBF-update 
uloan 

loan 





MENU: Delete 
FRAME. tdelete 
USAGE. user 
FORM tdelete 
PROCEDURES. 


tdelete.os! 
dloanc.qc 
dbackc.qc 
dtapec.qc 





TS 


on 3 
NO 
NO 


AEPENDIX GE 


FRAME DEFINITIONS 


MENU: Topframe 
FRAME: topframe 
USAGE: user 

FORM: topframe 


Soke FUNCTION 


t query/report (terminal) 


p gquery/report (printer) 


add 
update 
delete 


exit 


ADD UPDATE DELETE lap.Cit sue 





PROCEDURE: topframe.cs] 


t = {callframe tquery; } 
p = {callframe pquery;} 
add = {callframe tadd;} 
update = {callframe update; } 
delete = {callframe tdelete;} 
exit = f{exit;} 


Ls 


ipa 

MENU: TQuery/Report (terminal) 
FRAME =) Vequer vy 

USAGE: user 

FORM: Cie ie, 


QUERY/REPORT TO TERMINAL 


scratch 


periodic (db, we,ams,.o.) 


individual) (Sees ee) 
vendor 

student 

loaned 

date to retire 

ie Gaia 


exit 


SCRATCH PER IND VEN STU LOAN DATE RETURN Pe 





PROCEDURE: tquery.osl 


scratch = {callframe rscratch; } 
per = {callframe rpe;} 

ind = {callframe rind; } 

ven = {callframe rvendor;} 

stu = {callframe rstudent;} 
loan = {callframe reploan;} 
date = {callframe rdate;} 
return =| {rerun 

exit = f{exit;} 
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ie. 1 

MENU: scratch 
FRAME: xrscratch 
WaAace:; report 
FORM: iIPSce nae Chit 


ENTER SCRATCH REPORT PARAMETERS 


Mee nye etl: max length: 


mele REPORT RETURN: 





Pierce em i autcs.s Mandatomy = Maxglongth 


MmerPORT: rscratch 


11-SEP-1985 O65 O04 
REPORT ON SCRATCH TAPES 
Table is: vscratch 


Sie derr 
(mm/dd/yr) (mm/dd/yr) 





Reopen ewleniInLtilon: «SOrt by wlemeaen, boi, errors, id 
Select length by range at runtime 
Output to terminal 
Command flag ~ L80 


TABLE: mScClactcn 


25 


‘lroeillitaeZ 

MENU: Periodic 
FRAME: rpe 
USAGE: report 
FORM: rperf 


ENTER PARAMATERS FOR VEER POUT eee ACh UPeRE CORT 
Table is: vpe 


oer system: 


Mim (de iee ae: nleb,< Clichelers Sela) 


pPabtrays.. Sa aoise 


REPORT  REEURIT: 





Field Attributes: 
Mandatory - type; system, max dcreac, acum 
dick, sav sre (type = db, wh, mb, 
Gio Or a Only) 
Validation= type in |[db; wb, mb, ob 
system (refer to Appendix C) 
* selects “alls 


REPORT: rper 
11-SEP-1985 10:34:12 


REPORT, ON PERTODIC BAGKUES 
Report on Table: vpe 


dcreate: mm/dd/yy 
: SYSECR. 
sequ: p4.1 part disk: 
Sav_ Src: 





Report Definition: Sort by tyee, dercatce, syseen- 
part Grsk,  se@uroad asiac 
Select dcreate by range at runtime 
Select type, system, part disk, 
Sav src by value at runtime 
Output to terminal 
Command Flag - L80 
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ea. 3 

MENU: Individual 
FRAME: rind 
MoAGE: report 
FORM: ig iLgisbE 


ENTER INDIVIDUAL BACKUP REPORT PARAMETERS 


aoe. 


part disk: 


Mee REPORT RETURN: 





Field Attributes: 
Mandatory - type, owner, system, part disk, 
Say Src _ 
fujock— Morin or * Only) 
Validatren=—  eypentne is et, May", Ue] 
System (refer to Appendix C} 
"x" selects all 


REPORT: rind 


11-SEP-1985 iO 36504 
REPORT ON INDIVIDUAL BACKUPS 

Table is: vind 
type: system: med Laity: length: (14) 
owner: Par Cucisic. label: Perusa: (12) 
dcreate: (mm/dd/yy) sav_src: pees (15) “errs (12) 
moe «6(15) descr: 

Sequ, (hoa) sadvisor: Gone ph: 


Report Definition: Sort by type, owner, dcreate, 
System, sequence 
Select type, owner, system, 
peee cisky Sav src by vaiue at 
runtime - 
Ouegues tO terminal 
Command flag - L80 


feels: vind 


ie 


eee 

MENU: Vendor 
FRAME: xrvendor 
USAGE: Wepore 
FORM: rvendorf 


ENTER PARAMETERS FOR VENDOR REPORT 
Table is: vven 


software: vendor: 


system: 
HEGe REV OR)T Mehr UR 


Field Attributes: 
Mandatory - software, vendor, system 
Validation- system (Appendix C) * selects all 


REPORT: rvendor 


io ede) 12:46 
REPORT ON VENDOR TAPES 
Report on Table: vven 


software: part dwsk: 
vendor: Sek Siaes 
system: descr: 
owner: advisor: 
Cle, Mies) COneon: 
segu: (f4.1) 





Report Definition: Sort by software, vendor, system, 
owner, sequ 
Select software, vendor, system, 
by value by runtime 
Output to tenpmimel 
Command flag - L80 


TABLES. vven 


el). 5 

MENU: Student 
FRAME: rstudent 
USAGE: report 
FORM: rstudentf 


ENTER PARAMETERS FOR STUDENT REPORT 
Table is: vstudent 


in adcreate: max dcreate: 
reme : S¥o een: 
HELP REPORT RELURN: 


Field Attributes: 
Veneto 7 a= ind sachreake,;, Name, System 
Validation- System (Appendix C) *selects all 


REPORT: rstudent 


miewst;P-1985 Olt) 2 2 6 
REPORT ON STUDENT TAPES 
Report on Table: vstudent 


dcreate: (mm/dd/yr) system: _label: 
name: babe disk: Weal Ly’: 
meqgu: (f1.1) Sete) epee bpi: (15) 
mae (15) descr: advisor: 
Sone: 


Report Definition: Sort by dcreate, name, system, 

part disk, segqu, sav src 

Select dcreate by range at 
runtime 

Select name, system by value at 
runtime 

Output to terminal 

Command flag - L80 


PABLE : vstudent 


ES, 


ee 

MENU: Loaned 
FRAME: reploan 
USAGE: user 
FORM: reploan 


SELECT TYPE OF Lesnar row!) © eke Cn. 


Scraben 
backup OfAvendor 
return 


Soe 


SCRATCH BACKUP <RETURN See ci? 


PROCEDURE: ~eplcanwess) 


scratch. = {callframe Inscratch; } 
backup = {callframe rloan;} 
return = f{return;} 

exit - f{exit; } 
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il. GO. L 
MENU: 
FRAME: 
USAGE: 
FORM: 


HELP 


mae ORT s 


Seratch 

ise raten 
LFeport 
default blank 


REeORT RUN: 





Inscratch 


ieee P-1985 


FABLE : 


REPORT ON LOANED SCRATCH TAPES 
Report on Table: vscloan 


edr: (mm/dd/yr) 
aQloan: (mm/day yx} 





ReSOmee Denim! t LON: Sorte by ad 
QOUEDUG stewererni nal 
Command flag - L80 


vscloan 


Lok 


Balls cee 

MENU: Backup or Vendor 
FRAME: rloan 

USAGE: <Tepore 

FORM: rloanf 


ENTER PARAMETERS FOR LOANED TAPES REPORT 
Table is: vlioan 


Mino ear: max edr: 


loanto: 


HEEP “REPORT “=Remwkiv: 





Field Attrlpuces: 
Mandatory - max _edr, loanto 


REPORT: rloan 


L1-SEP-1985 10:40:26 


REPORT ON LOANED BACKUP AND VENDOR TAPES 
Report on | Table lean 


1s fees) LOadgieEe. type: 

edr: (mm/dd/yr) lente: software: 

dloan: (mm/dd/yr) owner: system: 
sequ: (f4.1) 





Report Definition: Sepe by id 


Select - edr by range at runtime 
loanto by value at 
runtime 
Output file - terminal 


Command flag - L80 


TABLE: vioan 


le. 7 

MENU: Date to Retire 
FRAME: rdate 

MSAGE: report 

FORM: rdatef 


ENTER PARAMETERS FOR RETIREMENT DATE REPORT 
Table is: vretire 


ie aret ice : ceaenae ed: ire 5 
type: 
mete REPORT RETURN: 


Field Attributes: 
Mae re Ois aol cen Grac Ieikiac yamrietyiOc 


REPORT: rdatef 


Me SEP-1985 | LO SSMAES 
REPORT ON RETIREMENT DATES 
Report on Table: vretire 


dretire: (mm/dd/yr) type: he ngie tie 14 | 
dcreate: (mm/dd/yr) system: Jojo (Rep 
mee (15) Secu Wb 4 ail) ratngs eee (ay 





Report Definlt1lOn: Sse@nn by acetlre, Eype, dcreate, 
system, sequ 
Select dretire by range at 
runtime 
Select type by value at runtime 
Output file - terminal 
Command flag - L80 


TABLE : vioan 


L338 


Nae 

MENU : PQuery/Report 
FRAME: pquery 

USAGE: user 

FORM: pouery 


SELECT PRINTED a eor tT 


Seinen 

periodic backups (db, wb, mb, gb) 
individual backups ws), 20. au) 
Vena ois 

student 

loaned 

date to retire 

dump 

ie eek) 


exit 





SCRATCH PER IND VEN STU LOAN DATE DUMP RETURN  EXa 


PROCEDURE: ‘ pegeny cet 


scratch = {callframe pscratcnh; } 
per {callframe pperiodic;} 


ind = {callframe pindividual; } 
ven = {callframe pvendor;} 

stu = {callframe pstudent; } 
loan {callframe prloan;} 


date = {callframe pdate;} 
dump = {callframe pdump; } 
FeCurn = {retire 

exit = fexit;} 
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1 Ae 

MENU : S@ieacen 
FRAME: pscratch 
MomGe: report 
DORM : pscratchf 


ENTER SCRATCH REPORT PARAMETERS 


fem length; max Teng ieh:: 


CUEBUES EOuEL rhe: pscratch 


meee REPORT RETURN: 


BPrctCmAeErlbubes: “Mandatory = max length 


Beek T: pscratch 


11-SEP-1985 EUR 41 35 
REPORT ONS SCRATCH TAPES 
Report on Table: vscratch 


length bem err derr 
(14) (15) (2) (mm/dd/yr) 





ReSpemen Perini tions) Sont by lengiEhn, bpi, err, id 
Select length by range at runtime 
GucputwrL&ile - pscraten 
command flag - L132 


TABLE: Veecrarch 


5 


Le s2 

MENU: Periodic 
FRAME: pperiodic 
USAGE: report 
FORM: pperf 


ENTER PARAMETERS FOR PERIODIC BACKUP REPORT 
Table is: vpe 


Ey De. SYS UeiIn: 
min dcreate: EBS clei Scies - 


part disk: sav src: 


OUTPUTS CO fl levee perl odie 


HELP REPORT RETURN: 





Field Attributes: 
Mandatory - type, system, max dcreate, 
part disk. ceuweconme 
Validation- type = db, wb, mb, gb, * 
System (Appendix C) * selects all 


REPORT: ppe 
is Pe ; 


REPORT ON. PERL ODSGseaChUP Tere 
Report on Table: vpe 


WG sos S:) type: dcreate: (mm/dd/yr) system: 
Wei ey; label: Spas (235) err: (iz 


Par cmcesi:: Sree) sicioke 
sequ: (f£4.1) descr: 





Report Definition: Sort by type, dcreate, system, 
part disk, segu, sav src 
Select type, system, part disk, 
Savusre by Valuerac nunmmrme 
Select dcreate by range at runtime 
QuLbUL LO fille = oper lec. 
Command Plag — biz 


TABLE: vpe 


LG 


ie 2.3 

MENU: Higtealsraleibeeyll 
FRAME: pindividual 
WSAGE: report 
FORM: Ouljaue be 


ENTER INDIVIDUAL BACKUP REPORT PARAMETERS 


iy De : 


faee disk: 


Sutoutes to files pind vidual 


fee REPORT RETURN: 





Field Attributes: Mandatory - type, owner, system, 
Selo, Chl Se S ey Scpate 
(Eyoe==) 1S,)tt, Ju, Or * only) 


REPORT: pind 


L1-SEP-1985 125) 2 (dbs 
REPORT ON INDIVIDUAL BACKUPS ; 
Table 1s: vind 


type: system: Darse disk: 
owner: sequ: (f1.1) Saye slc: 
dcreate: (mm/dd/yr) sou wy (21,15) descr: 
Peal ity : length: (14) advisor: 
label: perusd: (12) EOnton: 
for: (15) Grr se 2) 


Report Definition: Sort by type, owner, dcreate, 
system, sequ 
Select type, owner, systen, 
Pam@enclst,~sav src by value 
Cuaoteeeomnimle = pindividual 
Cemmana shlagr— L132 


Peele: vind 


Gey 


deena 4 

MENU: Vendor 
FRAME: pvendor 
USAGE: report 
Beri: pvendorf 


ENTER PARAMETERS FOR VENDOR REPORT 
Table is: vven 


software: vendor: 


system; 


outputs to file: pvendor 


HELP RKEPORT REDURN: 





Field Attributes: 
Mandatory - software, vendor, system 
Validation-= system (Appendix C) * selects eam 


REPORT: pvendor 


11-SEP-1985 Ll?S 3a 
REPORT ON. VENDOR DArPES 
Report on Table: vven 


software: system: pawmerdicies: uta Tiey. err: (ia 
vendor: Sequ: (f£4.1) Saves isc: Laibeie: advisor: 
owner: Ta) descr: Dried) COnNtpRA. 


Report Definition: Sort by software, vendor, system, 
owner, sequ 
Select software, vendor, system 
by value at runtime 
Output to file - pvendor 
ConmanGa Elage-s blsZ 


TABLE < vven 
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ee «5D 

MENU: Student 
meaMeE: pstudent 
MeeGe>: report 
FORM: pstudt 


ENTER PARAMETERS FOR STUDENT REPORT 
Wabvewiss vVStudent 


fen sdcreate;: Merqucletacet =; 


mame = system: 


outputs to file: pstudent 


meee REPORT RUN 





Field Attributes: 
ManeatOry = Max Cetedte, mame, System 
Validation- system (Appendix C) * selects all 


PeeoRkt: pstud 


eos P—1985 iis Do OO 
REPORT ON STUDENT APES 


Report on Table: vstudent 


dcreate: (mm/dd/yr) name: system: 
mee (15) advisor: Dame disk: 
sequ: (f£4.1) ConEpin: Savor: 

etre tasy : descr: 

label: 

lovee i 5) 


Report Definition: Sort by dcreate, name, system, 

PA@aecsemceau, Sav Src 

CelectiGeneaser by cange at 
runtime 

Select name, system by value at 
runtime 

Output to file - pstudent 

Command flag - L132 


TAS LE : AVE nye! 


Leo 





Lcge6 

MENU: Loaned 
FRAME: prloan 
USAGE: user 
FORM: reploan 


SELECT TYPE “Cr VhbOANED Apes Oe nb PORT 


SCraktenh 


backup or vendor 


return 


eo c 


SCRATCH —~ BACK” RETURN ~SxX12; 





PROCEDURE: priocan.osl 


scratch = {callframe plnscratch; } 
back = {callframe ploan;} 

return = f{return;} 

exit = {exit;} 
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ime ©. 1 

MENU: Seracch 
FRAME: pilnscratch 
Womens: report 
FORM: pinscratch 


Suepucs to file: pinscratch 


meee REPORT RETURN: 


REPORT: plnscratch 


11-SEP-1985 | 11:08:19 
REPORT ON LOANED SCRATCH TAPES 
Report on Table: vscloan 
loanto: Lenin: edr: Geen: 5Gl sa (ase) 
(mm) Gey 7 (mm/dd/yr) 


Report Definition: Sort by name, id, edr 
Output to file - plnscratch 
GConmand “flag -— irs 2 


TABLE: vscloan 
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dime es Oteee 

MENU: Backup or Vendor 
FRAME: ploan 

USAGE. remote 

FORM: ploanf 


ENTER PARAMETERS FOR LOANED TAPES REPORT 
Table is: vloan 


mane cia : max edr: 


loanto: 


GUEDPUES -Co filles Speloan 


BELP REPORT FEURN. 





Field Atwetputes: Mandatory > Macwne cis @aniae 


REPORT: ploan 


LI=-SEP=-1985 lisil0sG2 
REPORT ON LOANED BACKUP AND VENDOR TAPES 
Report on Table: vloan 


loanto: edr: (mm/dd/yr) dloan: “(mm addy vm) 
Vas, (C15) Fenton. 

type: Owiite ia: Ss) eee 

software: segqu: (f£4.1) 


Report Definition: Sort-by mame, -ecr., td 
Select edr by range at runtime 
Select loanto by value at runtime 
OUutpUG to Erle == plean 
Command flag - L132 


TABLE: viloan 
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15 ee 

MENU: Date to Retire 
FRAME: pdate 

USAGE: report 

FORM: pdatef 


ENTER PARAMETERS FOR RETIREMENT DATE REPORT 


Gaple 1S) vretire 
Tp dLjol_(ehgisnealeal nlevs chetsreshas x 
type: 
GUEDUES EO (fl lece pretare 


meme REPORT RETURN: 


Pi rennee toutes: Mandatomy = max dretire, type 


REPORT: pdate 


meee P—-1985 MiQieca ysl 
Ive Ow Ohh Mice MEN DAE S 
Report on Table: vretire 


dretire: (mm/dd/yr) type: dcreate: (mm/dd/yr) 

mae: (15) 

system: segu: length: , joven aie. 
(eee) (14) C5) (2) 


Report Definition: Sort by dretire, type, dcreate, 
system, sequ 
Select dretire by range at 
runtime 
Select type by value at runtime 
Output to file - pretire 
Gonmana-tlag y= L132 


imABobE: vretire 
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13288 

MENU: Dump 
FRAME: pdump 
USAGE: user 
FORM: pdump 


SELECT TABLE PCR VDE eRe er. 


cave 
sets 
file 
student 
loan 
return 


exit 


TAPE SETS FIRE «SFU sLOAN SRE DUR Sei 


PROCEDURE:  pcump eos! 


tape = fcallframe tape; } 


sets {callframe sets; } 
file = {callframe file;} 
stu = fcallframe student; } 
loan = {callframe loan; } 
BeOCULT =r etiaemc 

Sit = ewe | 


144 


lo Aas 

MENU: Tape 
Paes tape 
USAGE: report 
FORM: tape 


outputs to file: dtape 


foe REPORT RETURN: 





REPORT: tape 


fee oEP-1985 Inet aes on) 
DUMP 
Report on Table: tape 


length bpl derr 
(14) (1n5)) (mm/dd/yr) 





Reeemge Definition: “Sept by id 
Output to file - dtape 
Command flag - L80 


TABLE: tape 


145 


Lies 32 

MENU: Sets 
FRAME: sets 
USAGE: report 
FORM: sets 


OutpUES to Liles) Pdscec 


HEDP “REPORT Relenh: 





Roe Ohi tse. 


11-SEP-1985 10:50 28 
DUMP 
Report on Table: sets 


ied $= (aS) type: (c2) dcreate: (mm/dd/yr) 

software: vendor: 

descr: 

dretire: (mm/dd/yr) system: te eye: 
owner: advisor: 

label: perusd: (12) 

Con Gola segqu: (f£4.1) 


Report yDefLinition: Semen bye 
Output to file - dsets 
Command flag - L132 


LABILE sets 


146 


m2. 6.3 

MENU: File 
FRAME: file 
wees. §«=6report 
FORM: file 


outputs to file: dfile 


meee REPORT RETURN: 





REPORT: file 


11-SEP-1985 Hees 49 
DUMP 
Report on Table: file 


part disk San) sic e 





Beopout wWerINLELoOn: Sort oy 41d 
Output to file - dfile 
Command flag - L132 


TABLE: file 
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We 2 os 
MENU: 
FRAME: 
USAGE: 
FORM: 


i cp yy 


REEOR? ¢ 


Student 
student 
report 

student 


OUuLpDUES EOrt eile: 


REPCRY “REURN: 


student 


i= Series 


TABLE: 


DUMP 
Report on Table: 


advisor 


dstudent 


student 


Report. Define ome oom: woe 
Output to file - dstudent 
Command flag - L800 


student 


Cone pi 


1035 is 





‘lL. Zee 

MENU: Loan 
FRAME: loan 
Wenoks report 
FORM: loan 


outputs to file: dloan 


foie REPORT RETURN: 


REPORT: loan 


mee oh P1985 Oa 3.2305 
DUMP 
Report on Table: loan 


ilye| dlioan edr loanto 
15) mm? aay yr) (mm/dd/yr) 





Repobe Definition: Some by 4 
Output to file - dloan 
Command flag - L132 


TABLE : loan 


149 


digas 

MENU: Add 
FRAME: tadd 
USAGE: user 
FORM: tadd 


SELECT ADD 


scratch 


vendor 


backup 


files 


students 


loan 


beeur in 


SCRATCH VENDOR BACKUP FILES STUDENTS LOAN RE@OR- 


PROCEDURE: 





tadd.osl 

scratch = {callframe ascratch;} 
vendor = {callframe avendor; 3 
backup = {callframe abackup;} 
files = {callframe aafiles;} 
students = {callframe astudents;} 
loan = {callframe aloan;} 

return = {return; } 


ime. L 
MENU: 


FRAME: 
USAGE: 


FORM: 


Lele 


Scie slice gl 
ascratch 
user 
anoscratch 


ADD SCRATCH TAPES 
Table 1s: tape 


length: jeyoul f 


select id; enter data, add 


Po ADD RETURN: 


Field Attributes: 
Display only - id 
Repeat values for - length, bpi 
Mandatory - length, bpi 
Validation - length, bpi. (Appendix C) 


PeeecBODURE (1): ascratch.osl 


td = {cal lproc sgetid-: 
aden = uGal lpErOecrascrarenc =: } 
Merwin ==, (recurn: 3 


iigeie 


123.1 (Conernued) 
PROCEDURE 2)i: sSGetld. ge 
sgetid() 


# # aye low; 
t # su gue top; 


# # Die new; 
PW ene ie 
1=low=0; 
+ # retrieve (low=min(tape.id *retrieve an empty slot 
# # where (tape.length=0 and with the lowest id 
# # (tape .bp1i=0) ) ) 
# # { 
Be oa oa lee 
# # } 
if (low! =0) *i1£ an empty slot exiere 
{ 
# # putform anoscratch (id=low) *put the id on the form 
# tt message "OLD ID" 
+ # sleep 2 
# # Be elon 
} 
else *if no empth slots exist 
{ 
+ # retrieve (top=max(tape.id) ) 
# # { 
1t++; 
# # } 
Lt Aeop-)) 
{ 
new=1+top; *increment the max id 
assigned by one 
it # putform anoscratch *pout the new id number 
+ # (id=new) on the form 
t it message "NEW ID" 
t # sleep 2 
return; 


TABLE: tape 


f— 
Una 
ho 


‘Ls Sal 


PeeceDURE (3): 


# # 
# # 
tt 
# i 


# # 
# # 


tt 
# # 


# # 


# # 
tt 
tt 


# # 


# # 
# # 
tt 
t # 
it # 
# # 
# # 
t # 


# # 
+ # 


tt 
tt 
t it 


(Continued) 


asctraccene.GgCc 


ascratchc() 
fmt nu; 

fei) le; 
beeke b; 

Tji9ee check; 
nat 1? 
m=check=0> 


getform anoscratch (nu=fid, 
le=length, b=bpi) 
mamma = =O) 
{ 
message "Select ID before 
entering data” 


Sleep 2 
BeLUrN: 
3 
retrieve (check=tape.id) 
where tape.id=nu 
{ 
= 2 io a 
3 
if (check>0) 
{ 
Bepilace. ape 
(length=le, bpi=b) 
where tape.id=nu 
message "Added to old 
ID; label tape only" 
Sleep 2 
Paw OlrmMvan@Oscra cen 
(id=0) 
return; 
3 
else 
{ 
append to tape 
( 
id=nu, 
lengthe=le, 
Jaycliheae: 
) 


SS 


*get the values from the 
form 


*if the user tried to 
enter data prior to 
getting an id 


*find a record of an 
empty slot with the id 
number 


*if an empty slot of the 
id number exists 
*update the record of 
the empty slot in the 
tape table 


*if the id is not in the 
tape table 
maooenad £O Lape Cable 


1.3.1 (Ceonretucged) 


t # message "Added to new 

# # ID, label slot and tape" 
# # sleep 2 

t # PULEOFMN anescuare: 

# # (id=0) 


} 


TABLE: tape, sets 
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*to prevent double entry 


a 

MENU: Vendor 
FRAME: avendor 
USAGE: user 


FORM: advendor 
ADD VENDOR TAPES 
Tables are Tape and Sets 
ic : type: dcreate: dretire: 
system: Heelies: label: Do: 
owner: advisor: GOnmereo lh: 
software: vendor: 
descr: sequ: 


select id; enter data; add 


cee ADD RETURN: 


Field Attributes: 
Display only - id, type 
Repeat values for all except id 
Mandatory - dcreate, dretire, system, utility, 
bp1, software, vendor 
Validation - system (Appendix C) * selects all, 
bp1l (Appendix C) 


PROCEDURE (1): avendor.osl 
id = {callproc vgetid;} 


add = {callproc avendorc; } 
return = {return; } 


ibeks 


1.3.2 (Continued) 
PROCEDURE “2)5s) “vgeeraace 
vgetid() 


# # abeue low; 
# # TeQue ops 


# # gue new; 
Inc 3 
i=low=0; 
+ # retrieve (low=min(tape.id 
+ # where (tape.length=0) and 
# # (tape.bpi=0) )) 
+ # { 
L=1i+1; 
t # } 
1£ (Lowl=0) 
{ 
t # putform advendor 
it # (id=low, type ="v") 
t # message "OLD ID" 
# # sleep 2 
return; 
} 
else 
{ 
# # retrieve (top=max 
+ # (tape.id) ) 
t # { 
1t++; 
ft # 
sali (ace) o> 2101) 
{ 
new=1+top; 
t # putform advendor 
+ # (id=new, type="v") 
+ # message "NEW ID" 
+ sleep 2 
Fe eli 
j 
} 
} 
TAB Ti: tape, vendor 


ie 


*retrieve an empty si@e 
with the lowest id 


*if an empty slot exists 


*put id and type on the 
form : 


-*1]£ no empty slots exise 


*increment the max id by 
one 
*put the new id and type 
on the form 


ie «2 


meeeEDURE (3): 


tt 
# 
# # 
tt 
tt 
# # 


# i 
tt # 
# i 
tt 
# i 
tt # 
# i 
tt # 
# i 


t # 
# # 
tt 
tt 
tt 
tt 
tt 


tt 
tit 
tt 


tt 
# it 
tt # 


tt # 


# tt 


tT 


(Continued) 
avendone. Gc 


avendorc.qc() 


eke gal 
char ENA 
emar da|Zo > 
char aetZo\ > 
char sy[{9]; 
char utf6f[> 
char ow[9]; 
char Co. 4 |) 
char so[{15]; 
char ve[20]; 
char la[6]; 
float se; 

sLigya leye 

char def{15]; 
char ad[9]; 
aera check; 
iLgee 1; 


getform advendor (nu=id, 
ty=type, da=dcreate, 
dr=dretire, sy=system, 
ut=utility, ow=owner, 
co=contph, so=software, 
ve=vendor, la=label, 
b=bpi, de=descr, ad=advisor) 


ieee (nu = 0 } 
{ 


message "Select id before 
selecting add" 

sleep 2 

return; 

} 

1=check=0; 

retrieve (check=tape.id) 


where tape.id=nu 


{ 


} 

iheveneck > 0) 
{ 

replace tape 
tape.id=nu 


i++; 


(bpi=b) where 


oy 


se=sequ, 


*get the values from the 


hOrM 


rleewcne USer tried to 
enter data prior to 
Paeernia aiid 


*find a record of the 
empty slot with the id 
number 


*if an empth slot of the 
id number exists 
Pwecdace the record of 
the empty slot in the 
tape table 


ES 


it # 
t # 
# # 
#7 
tt 
tit 
it # 
# 
# # 
it # 


TABLES 


(Concluded) 


append to sets(id=nu, type=ty, 
dcreate=da, dretire=dr, 

system=sy, utility=ut, owner=ow, 
contph=co, software=so, vendor=ve, 
label=la, sequ=se, descr=de, 
advisor=ad) 

message "Added to old ID; 

label tape only" 


sleep 2 

putform advendor (id=0) 

recurn: 

3 

else *if the id is not in the 
{ tape table 

append to tape ( *append to the tape 
id=nu, bpi=b table 


) 
append to sets(id=nu, type=ty, 
dcreate=da, dretire=dr, 
system=sy, utility=ut, owner=ow, 
contph=co, software, so, vendor=ve, 
label=la, sequ=se, descr=de, 
advisor=ad) | 
message "Added to new ID; 
label slot and tape" 
Sleep 2 
putform advendor (id=0) *to prevent double entry 
3 


tape, set 


ihsie' 


jes . 3 

MENU: Backup 
FRAME: abackup 
USAGE: user 
FORM: abackup 


ADD BACKUP TO SCRATCH 


Ben Lodue 3(db, “wo, emogarci) 


Praivucual (1S, Le, 10) 


return 


PeehODIC INDIVIDUAL RETURN: 





PeoepDURE: abackup.osl 
periodic = {callframe aperiodic; } 


individual = {callframe aindividual;} 
return = {return;} 


ies, 


oS 

MENU: Periodic (db, wh, mb. 4) 
FRAME: aperiodic 

USAGE: QBF-append 

FORM: aperiod 


ADD ID AND BACKUP DATA FOR EACH ID IN SET 


Table is: sets 
aces label: sequ: 
type: dcreate: dretire: 
system: Ute ye: 
descr: 


APPEND #1 (CONTROL F TO ADD, <MENU KEY> TO RETURN: 


Field Attributes: 
Mandatory - id, type, dcreate, dretire, 
system, utility 
Repeat values for - type, dcreate, dretire, 
system, utility, label, descr 
Validation- Not id in sets 
Type in (db, wee mb, eas) 
System (Appendix C) * selects all 


TABLE: sets 


160 


ies. 3. 2 

MENU: Pmigdividuale (is, 1£, iu) 
FRAME aindividual 

USAGE: QBF-append 

FORM: zl hiqvelarenirel 


ADD ID AND BACKUP DATA FOR EACH ID IN SET 


Table is: sets 
ards label: sequ: perusd: 
type: dcreate: dretire: 
system: ited seat yee 
owner: advisor: exe Quejclee 7 
deser: | 


APPEND #1 (CONTROL F TO ADD, 


Field Attributes: 


<MENU KEY> TO RETURN) 


Mandatory - id, type, dcreate, dretire, 
system, utility, owner 
Repeat values for type, dcreate, system, 
utility, owner, advisor, 
GOonepn, descr 
System (Appendix C) * selects all 
Validation- Not id in sets 


Ly ee 


menses sets 


Ds ilies ee ee | 


is\ ab 


tees ee 

MENU: Files 
FRAME: aafiles 
USAGE: user 
FORM: aafiles 


ADD: FULE eats. 16 


new backups or vendor 


old partial individual tape (and change perusd) 


return 


exit 


OLD -REIURN shx i: 





PROCEDURE: aafiles.osl 


new = {callframe afiles;} 
old = {callframe adfold;} 
return = {return; } 

exit = f{exit;} 


hg 2 


5 3 aaa 

MENU: New Backups or Vendor 
FRAME: afiles 

Teach: QBF-append 

FORM: afiles 


ADD FILE PATH 
Table is: file 


ie ie pele Chl Gils = 


Say Sic 


IF ONE FILE PATH HAS MORE THAN ONE ID, ADD ID AND FILE 
Seer OR BACH ID. IF ID CONTAINS MORE THAN ONE FILE PATH, 
meoe ID AND FILE PATH FOR EACH FILE PATH : 


PeePeND #1 (CONTROL F TO ADD, <MENU KEY> TO RETURN 


BretdeAeiri butes : 
Wevolslenes) eye ikel a yekeliqie | (slalicy cs (sie R ate: 


ieee: file 


os 


Poor 4s 2 

MENU: Old Partial Individual 
FRAME: aafold 

USAGE: user 

FORM: afold 


ADD FILE PATH TO OLD PARTIAL INDIVIDUAL 
Tables are: file and sets 


part disk: skeliy ieuele & 


perusd: 


enter datanandsselec reace 


RETURN 7 Ei: 





Field Attributes s eManda COry sa clay cee es ay 
Sav esre 


PROCEDURE (1): adfold.osl 


add = {callonec-satlotde |) 


return = f{return;} 
exit = fexit;} 
PROCEDURE: (2)222 -raibo ide. ce 
ae kode. (3 
{ 
# # ene nu; 
# # char pd([9]; 
+ # Char ss[15]j; 
+ # Dore DE 
+ # getform afold (nu=id, pd=part disk, ss=sav_src, 
+t # pr=perusd) 
ii 6 ie —— sO 
{ 
+t message "You must ender an ID before selecting 
+ add" 
FeCUrh: 


3 
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ieee. 2 (Continued) 


+H append to file (id=nu, part disk=pd, sav_src=ss) 
# # replace sets ( 

+ i perusd=pr 

+ tt ) 

3 


[Meapie: file, sets 


Ge 


Lee ees, 

MENU: Students 
FRAME: astudents 
USAGE: QBF-append 
FORM: astudent 


ADD ID AND STUDENT DATA 
FOR EACH ID THE STUDENT'S FILES ARE IN 
Table is: student 


ihre i name: 


advisor: Conroe: 


APPEND #1 (CONTROL F TO ADD, <MENU KEY> PO ReLUR ie 





Field Attributes: 
Mandatory ~ id, name, advisor, contph 
id in sets 
Repeat values for name, advisor, contph 


TABLE: student 


i . 6 
MENU: 
FRAME: 
USAGE: 
FORM: 


ma : 


Loan 

aloan 
QBF-append 
aloan 


ADD ID AND LOAN DATA FOR EACH ID LOANED 
Table is: loan 


dloan: edr: 


Geng ete) 4 ilesgie oels 


PePeND #1 (CONTROL F TO ADD, <MENU KEY> TO RETURN) 


iweb LE : 


Field Attributes: Mandatory - id, dloan, edr, 
loanto 


loan 


1.4 

MENU: Update 
FRAME: update 
USAGE: user 
FORM: update 


SELECY UPA: 


CGrEECcrs 


backup 


loan 
return 


exit 


ERRORS BACKUPS BOAN RETURN. EXEL: 





PROCEDURE: update.osl 


errors = {callframe errors; } 
backups = {callframe ubackup; 3} 
loan = {callframe uloan;} 
return = {return;} 

exit = f{exit;} 


es. 1 

MENU : Brerors 
FRAME: error 
USAGE: QBF-update 
ORM ; errors 


UPDATE ERRORS 
Hace. 1S: Wrarce 


derr: 


SeereR QUERY (<MENU KEY> TO RETURN OR TO RUN): 





Field Attributes: Mandatory - id 


ease: Cape 


IMs) ©, 


pee 

MENU: Backup 
FRAME:  Uipaekup 
USAGE: "ObE-update 
FORM: ubackup 


UPDATE BACKUP OR VENDOR DATA 
Table is: sets 


dcereate: dretire: 
advisor: CcOntph- 


descr: sequ: 


ENTER QUERY (<MENU KEY> YO RETURN JOR B@e Uli 





Field Attributes: Mandatory - id 


TABLE: “sets 


i 4.3 

MENU: Loan 
FRAME: uloan 
USAGE: QBF-update 
FORM: uloan 


UPDATE LOAN DATA 
Table is: loan 


id: edn: 


HOanto: Lesonejalels 


mek QUERY (<MENU KEY> TO RETURN OR TO RUN): 





Field Attributes: Mandatory - id 


WABILE : loan 


IE Ge 


es) 

MENU: Delete 
FRAME: tdelete 
USAGE: user 
FORM: tdelete 


DELETE 


las 
loan record (return tapes) 


backup (retire) 


tape (permanently remove) 


Feturn 


Cxit 


LOAN BACKUP TAPE RETURN EXIT: 





PROCEDURE (1): tdelete.osl 


loan = {callprocadleanc-s 
backup = {cal leroe deacee.| 
tape = {callproc dtapec;} 
return = {return;} 

exit = f{exit;]} 
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ioe 4 COnNCinued) 

PROCEDURE (2): dloanc.ac 
eloanc { ) 

int nu 


# 
# getform tdelete (nu=id) 
i mealete loan where loan.id = nu 


Ww te HE tHE 


ABLE : loan 


PeeeeDURE (3): dbackc.gc 
dbackc () 

: 

# # Metate nu; 


+ # getform tdelete (nu=id) 

+ # delete file where file.id = nu 

# # delete sets where sets.id = nu 

tF delete student where student.id = nu 


TABLE: file, sets, student 


PROCEDURE (4): dtapec.gc 
dtapec () 

{ 

# # hiakes nu; 


# # getform tdelete (nu=id) 


+ + pomete tile where file.id = nu 

# # qdelete loan where loan.id = nu 

# # pewter emsets where sets.id = nu 

# # eweterstudent where student.id = nu 

# i meplace tape (length=0, bpi=0,; derr=" ") 
where tape.id = nu 


TAPE: file, loan, sets, student, tape 


ee 


APPEND ier 
IMPLEMENTATION OF THE COMPUTER SGI ENCE DE PAR Ew 
TAPE GIBRARY Voy owEM 
The tape library system (TLS) application for the Com- 
puter Science (CD) Department was created using the 4.2 BSD 
UNIX operating system and the Ingres VMUNIX Version 2.1/15 
VE.04 DBMS. It was created under the name talibrary cs using 
login name crawfordb. It was developed using Ingres Appli- 
cations by Forms (ABF). An executable image [Ref. 4] has 
been built in the file /work/crawford talibrary.exe topframe. 


It is defined with the symbol cslib. 


A. LOADING 
The current library may be loaded into the tables at this 
time. Chapters III and IV of this thesis should be read 


before loading the library data. Data may be loaded into 


each table from a file using the copy command. The Ingres 
Self Instruction Guide [Ref. 5, p. 8-1] provides a Compre 
hensive explanation of the procedure. The following comments 


regarding the initial loading of data to file, Yor dinreaam 
Via the application will ensure the system operates as 
designed. 
ilies General 
Ingres reads the value of an upper case letter dif- 


ferently than the value of a lower case letter. Many of the 
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reports are called by value. It is recommended that fields 
be reviewed prior to loading, and where applicable, values be 
Standardized where validation criteria is not written into 
meme application. Computer records may not be duplicated in 
fm@emlibrary. 
2. Tables 

a hee ed pes Iie cEne Miitbraryee musts nave at 
least an id number and either length or bpi. If both length 
and bpi are null, the application will report the id number 
as one of a scratch tape. 

sig Sole talboeonls i tleldce= owner, Software, 
and vendor - are the most vulnerable to inconsistent value 
entry. When a record is loaded into table SETS, a record of 
the same id must also be entered in table TAPE. The same _ id 
should never a Saker Kobiclostion Syoe esse 

ee FILE. More than one record in table FILE may 
have the same id. If anid is included in TAPE, however, it 
feet also be in SETS. 

ole SRuDENT -. Student records are kept only for 
students whose files are contained in graduation backup tapes 
created for a graduating class. All of the graduated stu- 
dents files should be recorded on the graduation backup tape. 
The id numbers refer to the graduation backup tapes on which 
their files are recorded. An id may appear more than once in 
the table STUDENT. All ids in the STUDENT table should be 


ieeluced in tables FILE, SETS, and TAPE. 


ys 


e. LOAN. An id should not appear more than once in 
table LOAN. All id(s) in LOAN should appear at least in 


table TAPE, and may appear in table SETS and FILE. 


B. TABLE STORAGE STRUCTURE 


The storage structure of all tables is defined as a 


"heap". When the current library is loaded, the storage 
structure should be “Converted “co FP iaci eco accelerate 
performance of queries. This may be done by the following 
procedure. SUNIX,*Ingres) 


Singres talibrary - 
*modify <tablename> to hash 
The Ingres User's Guide [Ref. 5] and the Ingres Reference 
Manual [Ref. 4] provide further information on the structure 


and procedure. 


Cc. ACCESS 

Only the librarians should have access to tie t ee. 
To provide access, the library symbol "cslib" (no quotes) 
must be defined in the login files of each of the librarians. 
When the librarian retrieves a printed report from the li- 
brary, it 1s written to their UNIX work spaces. Therefore 
the librarians need work spaces large enough to store all 
reports defined in the application. Reports are described in 
Chapter IV, Section G. Documentation regarding the provision 
of access to users 1S in Applications by Forms [Ref. 6, 


pet 6—el. 
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APPENDIX "6G 
TUTOR TAL: 


ole ot rOnNeOr tHE COMPUTER SCIENCE DEPARTMENT 
PAbt et BRARY SYSTEM (Tis) 


TABLE OF CONTENTS 


FORMS --- 2-2 -- = - ~~ 
Ll. Menu FOYrMS ort ttt ttt ttt tt rt rr rrr rer 
2. Parameter Entry (for reports) Forms-------------- 
3. Run Report Forms--------------- 9 
4. Append FPormS----------- on nr er rrr errr reno 

a. Programmed id Assignmentee---------seese----- 

b. Programmed Append---------------------------- 

C. QBF-Append---9- errr errr rere rrr rrr 
5. Update FE ls Is = ee ene 
_. DSLECS 43 ae 
THE TLS APPLICATION-—-------- 99-9999 oe 
1. TQuery/Report—---- oe oe rer er 
2. PQuery/Report-------------- 
g Add ---------- - ~~ - -- 
“ Update------ ---- - -- - = 
5 De lete------------------ --- - -- - --- -- -- - --- + ---- 
MAINTENANCE PROCEDURES rrr r tert t tt ttt ttc rer sce 
1 Peak Performance------------------------------ == = 
2. Integrity------------------------- -- - - ----------- 
3. Security---------------------------- ----- -------- 
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This Appendix describes the operation of the TLS. Before 
using the TLS, librarians must read Chapter Lill, Sectionmeer 
Specification Data Dictionary; Chapter IV, Section B, Tables 
and Views; and Section C, Design Data Dictionary, of the 
thesis in order to understand the tables, data fields, and 
codes used in the application. Thorough descriptions and 
illustrations of the frames, forms, procedures, and reports 
are provided in Chapter IV, Section E, Frames; and Section G, 
Frames Definition. These should be referred to by frame 
number. Numbers are provided below. 

This tutorial is tnvenrees) parts. The first part de- 
scribes the types of forms used in the library and their use. 
The second part describes the application and which tasks or 
functions the various frames perform. The third part de- 
scribes procedures for the database SRO eer to maintain 
the library. 

The TLS is a frame-based application. Each frame has a 
form and/or report and a procedure associated with it. The 
librarian communicates with tne application by the use of 
forms. The application responds to the user by the use of 
forms and reports. 

The user may perform the functions of add, update, delete 
and retrieve. Data input is standardized and controlled 
through validation criteria. Operations are selected through 
the use of menus. The structure of the library and forms 


match the functions the librarian performs. 


ite 


Po FORMS 
There are six types of forms associated with frames in 


mae library: 


fet.) Menu, 

(eZ) Parameter Entry for Reports, 
fee RUN Report Forms, 

(4) Append, 

(5) QBF-update, and 

(6) Delete. 


Fach form has an operations menu at the bottom starting 
at the left hand corner. Many of the operation menus include 
the operations RETURN and/or EXIT. By selecting RETURN, the 
form of the previous frame will be displayed. Be Eee wie) | 
terminate the application and return to UNIX. To execute an 
operation, the user must enter a unique letter, or set of 
letters, which represent the operation to the right of the 


menu. For example, if the command menu is: 
SeraleH jo LUD RETURN Seer: 


enter sc to select SCRATCH or enter xr to select RETURN. 


Depress <ESC> to execute the operation. Operations are exe- 
cuted on all forms by using this’ procedure. The term 
"select" hereafter will be defined to mean "type" the repre- 


sentative command symbol, then depress <ESC>. 

When using forms which include fields for data input, the 
cursor must be moved from field to field. It will move to 
the next field automatically if the number of characters or 


integers of the value entered fills the field. If it does 


Lae 


not, however, the cursor can be moved to the next field by 
depressing the TAB key. To move it back to the previous 
field, depress control P. 
1. Menu Forms 
Menu forms provide movement to other frames. They 
contain the list of other frames on the upper portion and a 
matching list on the command menu line. A menu form is shown 


in Paguive 114 


SE LEC ieruNCTION 


t query/report (terminal) 
po QuUerYy/ PepoLle (pr licen 
add 

update 

delete 


exit 


TY oP ADD: UPDATE. ECS hae. 


Figure 11. Menu Form 
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When the menu form is displayed, the cursor will 
always appear to the right of the operations menv. To move 
to another frame, select the frame desired. The new form 
will be displayed. 

Peace cmmpmesieiee |. | Oem? , “12.60, 52sec, 133, 1.3.3, 
ios, and 1.4 display menu forms. 

2. Parameter Entry (for reports) Forms 

Parameter Entry Forms call reports based on values 
or ranges entered by the user. The forms contain fields in 
the upper portion and a command menu at the bottom. A para- 


Gemeer entry form is shown in Figure 12. 


Site ARAMElLpRoe FOR PERITODEC BACKUP REPORT 
Table 1s: vpe 


type: system: 


min dcreate: max dcreate: 


[ee eae Sav src: 


RBePORT RETURN: 





Figure 12. Parameter Entry Form 
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"Range" fields always anelude the prerttx inna 
max . Those that do not are “value fields.) input (oe a 
fields is mandatory. If a report is desired of all values of 
the value field, an "*" may be entered. Only the maxi 
field is mandatory. If all range values are desired, do not 
enter a value in the min_ range’ £iel@@and enter che "lana 
value allowed in the max range flel@y Partameten Encry semana 
always include the operations HELP, REPORT, and END. HELP 
will provide assistance to the user, REPORT will run the 
report, and END returns to the previous frame. When a Par- 
ameter Entry Form is first displayed, the euueee is always on 
the first field. 

HELP may be selected at any time during parameter 
entry. The form will be redisplayed intact after HHiemer 
been obtained. Select REPORT to run the report after ranges 
and values have been entered. Select END to return to the 
previous frame witchouce sunning the leeveme 

Frames J.l.i, d.1.2, 1.1.3, 12). 4)) eS ee ee eee 
lele7, 1.2.1, 1.262, 142.3; 1.254, 16 2 ee eee 
Gisplay Parameter Entry Forms. 

3s RUN Repere Forums 
Run Report Forms are used to run _ reports. No 
selection of values is available to the user. A Run Report 


Form is shown in Figure 13. 


Clteetes tO file: plinseratch 


fPeeee REPORT RETURN: 





Figure 13. Run Report Form 


The upper portion is either blank or displays a line inform- 
meee the user to which file the report will ee The 
command menu line is the same aS report parameter entry 
forms. 

Siacuo meme Os, wey Ot le moet 26a 2, Lede Gewd, 
eee. 4, and 1.2.8.5 display Run Report Forms. 

4. Append Forms 

Poot Ee iis Owe New ticei = Eemappend new records to 
the library. They display fields on the upper portion for 
data entry and a command menu line at the bottom. Append is 
Simple; there are three variations ot Append Forms. 

a. The first type of Append Form provides programmec 
id assignment, and is shown in Figure 14. 

This type of form iS associated with a procedure 

which automatically assigns an id number and perhaps another 
Value to the form. The fielcs which are automatically as- 


Signed are for display only. The cursor will alwavs appear 


ies 


ADD SCRATCH TAPES 
Table is: tape 


length: 


select id; enter data, add 


PDS eADD. “RETURN: 





Figure 14. Append Form (Programmed id Assignment) 


on the first field in which data may be aie eredeenen the form 
iS? “Initia “disp Uayeo- Before entering new data, the id 
number must be assigned. The command line at the boLoae dis-= 
plays operations ID, ADD, and RETURN. 

To get an id assigned, first move the cursor 26 
the command line by depressing <ESC>, then enter i RETURN. 
An id and perhaps other data will be assigned. Relevant 
notes regarding the labelling of cabinet spaces and/or tapes 
will be displayed next to the command line for two seconds. 
If the display says OLD ID, it means the cabinet space has 
been previously labelled, and the space is empty. Therefore, 
only tne tape need be labelled. If the display states NEW 
ID, no spaces were empty and a new id has been added to the 
library. Both the space and the tape must be labelled. 

After the id is obtained, the cursor will appear 


ym the first fiele in which data may be entered. TO ada Tee 


data, move the cursor to the command menu line and select 
ADD. After the append has been completed the form will be 
redisplayed. All fields will contain the old values except 
id. A new record may be entered which has all the same 
values, except id, by simply selecting ID, then ADD, or a new 
record may be entered by selecting ID and typing over the 
Gisplayed values, then select ADD. When all new records 
have been added, select RETURN to display the previous frame. 

Frames which display programmed id assignment 
Mmemms are 1.3.1 and 1.3.2. | 


loa Another type of append frame is the programmed 


append, shown in Figure 15. 


ADD PFIGE PATH TO OLD PARTIAL INDIVIDUAL 
Tables are: file and sets 


nivel ¢ Pats emcsia. Selves ie 


perusd: 
enter data and select add 


men RETURN EXIT: 


Figure 15. Append Form (Programmed Append) 


In the upper portion, the form displays fields 
into which data may be entered. ie displays the command 
menu ADD, RETURN, and EXIT at the bottom. When the form is 
initially displayed, the cursor will always appear on id. To 
add new records, simply enter new data and select ADD. 

Frame 1.3.4.2 displays a programmed append form. 

ome The third type of append form is a QBF-append. 


The initial display of a QBF-append form is shown below in 


BLqgure ele. 
ADD ID AND GOAN DATA FOR EACH Tb LeAnne De 
Table is: loan 
Tae CG Gem evelie = 
Loairee. Teint pln: 


APPEND #1 (CONTROL F TO ADD, <MENU KEY >wlOee tur 


Figure 16. OBFeappend Form 


To add data, fill in all the data fields dis- 
played in the upper portion and depress control F; the cursor 
does not need to be on the command menu line. After the new 


record has been entered the following form (Figure 17) wae 


D 


> displaved. 


\-, 
kL 


ADD ID AND LOAN DATA FOR EACH ID LOANED 
Table is: loan 


Gdl@an : 


liexeltieto) = ley eeeyena: = 


feeb +2 (CONTROL F TO ADD, <MENU KEY> TO RETURN) 





Figure 17. QBF-append Form 


(t 
a 
(D 


In some forms, some of the fields will retain 
previous values. If the previous value is not displayed, it 
may be recalled by putting the cursor in the field and 
aepressing control a. This will be especially helpful if you 
cannot remember the number of the last id entered. To add 
another record, simply change the appropriate values and 
emer control tf. If you do not desire to add more records, 
depress the menu key <ESC> and the form shown in Figure 1€ 
will be displayed. 

HELP provides information regarding OBF. ADD 
allows you to continue adding data. If END is selected, the 
previous form will be displayed. Frames which display CBF- 
eeeemeertenigeate 1.3.3.1, de5.3.2, 123.4.1, 1.345, and 1.3.6. 
More detailed information regarding OBF-append frames is pro- 


vided in the Ingres QOBF Users Guide [Ref. 6]. 


Wee 


ADD ID AND LOAN DATA FOR EACH ID LOANED 
Table is: loan 


dioan: 


loanto: 





Figure 18. QBF-append Form 


5. Update Forms 

Update forms are used to change values of records 
previously entered in the library. The update function con- 
Sists of two states, the QUERY state and. the GO state. While 
in the QUERY state, you may specify a query by filling in the 
form with the values of the records you are searching for. 
After filling in this form, OQOBF enters the GO state, mee 
trieves the row(s) you asked for, and allows you to update 


each row, one by one. The changes are stored in a temporary 


buffer, as you move from row to row. After changing all the 
rows, you can write out the buffer containing the changes to 
the table. After you update the table, you are returned fee 


the QUERY state to execute a new query. You can leave the 
CUERY or GO states at any time, either to execute another 


query or to return to the main menu of the operating system. 


as 
CO 
CO 


QBF-update frames display the form shown in Figure 19 


when selected. 


UPDATE LOAN DATA 
Table is: loan 


id: 


rGanto: 


Peek QUERY (<MENU KEY> TO RETURN OR TO RUN): 





Figure 19. Update Form (Query State) 


This is the QUERY state. Fill in the value or valves 
of the records you wish to retrieve. For the TLS, you will 
usually call records for update by id. You may use compari- 
son operators when specifying a query. These are: 
greater than = greater than or equal to 


> 
less than <= less than or equal to 
equal to '= not equal to 


hnYVv 


While in the QUERY state, QBF does not check fields to make 
Sure they contain valid data. This is done when you enter 
m@enmGO) State to run the query. 

fem OoUrRRY “Stave Nas a menu For running cueries, re- 


Serena £rom the function, restarting the query, anc getting 


Bee, 


help. To call the menu, depress the <ESC> key. The menu 


appears at the bottom of the screen. 
HELP QUERY GO END <command> 


You may call the menu at any time; it does not affect 
your data. If the menu was accidently called, depress RETURN 
EOPECTUrM EOC YOURSLOmm. To exit UPDATE, select the END com- 
mand and you will be returned to the previous frame. If you 
select QUERY, QOBF clears all the fields on your form so that 
you can enter a new query. All data on the ola form is iGo 
If you select GO the query 1s run. QBF enters the GO state. 
OBF will now display the following form (Figure 20) with the 
values of the record(s) you requested. You can now edit the 
rows you have just asked for by typing the new data over the 


ouleke 


UPDATE LOAN DATA 
Table is: loan 


gO eo 2dr: 9/ 26733 
[Can EO = —nuenroud TCHntDh= oa 


TYPE IN NEW DATA (<ESC> TO RETURN, COND Ole OR aa. 


FaGuiees. 20 Update Form (GO State) 


Mec ae) 


If no rows which satisfy the query are found, OQBF 
G@peplays the message - NO ROWS FOUND - and returns to the 
Oey State SO you May enter a new query. 

If you wish to go to the next row specified by your 
query, depress the control F key. If no rows are left, NO 
MORE ROWS LEFT IN QUERY, is displayed. 

At this point you have three options: (1) write your 
changes to the table; (2) start a new query; or (3) exit 
UPDATE, using the GO state menu. 

Your changes are stored ina buffer each time you 
depress the control £ key. These changes do ae change the 
table in the library until you issue the WRITE command in the 
SO estate menu. 

To enter the GO state, depress the <ESC> key. The 
following menu will be displayed: HELP QUERY WRITE DE iasale 
meee YOU may call this menu at any time. It does not affect 
Pemeendata. To exit without writing your changes, select END. 
Meme will be returned to the previous frame. If you want to 
begin your query again, select QUERY. The changes made will 
be erasea from the buffer and the QUERY form will be displav- 
ead. The DELETE key deletes the current row displayed on the 
Screen. There is no reason to use this key in the library. 

To write the changes you have made to the row(s), 
select the WRITE operation. If you have made changes to data 


and cdo not select the WRITE operation, the following messaqde 


ft 
WO 
}-2 


is displayed: DO YOU WANT TO LEAVE UPDATE WITHOUT WRITING 
CHANGES? Enter y for yes and n for no. 
Further information about UPDATE is provided in the 
Ingres QBF User's Guide [Ref. 6]. OBF UPDATE frames are 
L.4@ely 14.2; ands la ee 
6. Delete Form 
The Delete Form (Figure 21), 1s used to delete 


records. 


DELETE 


aves 

loan record (return tapes) 
backup (retire) 

tape (permaneneiy Gemevc) 


return 


ais 


LOAN BACKUP TAPE RETURN EXIT 


Figure 21. Delete Form 


On the upper portion, a field for id@and a@iast Gt operariene 


to be performed on the id number is displayed. 


The command menu repeats the operations listed on the 
Meeer portion. Additionally, RETURN calls the previous 
frame; EXIT exits the application. 

To use the delete frame, enter the id number of the 
tape on which the delete operation is to be performed. Move 
the cursor to the command menu and select the delete oper- 
ation desired. The delete occurs immediately. 


Frame 1.5 displays a delete form. 


fee lie TLS APPLICATION 

Fach of the librarians has been granted access to the 
imeerary. It may be called from UNIX by entering (% is the 
Pex prompty™: S™%cslib 

ie first Lbs Erame will display a form ~on the screen. 
The name of the frame is Topframe ana 1S number 1 in Appendix 
D. Topframe is the main menu of the application. It displays 
the major operations performed in the library: 


(1) TQuery/Report - print a report to the terminal 


(2) PQuery/Report - print a report to the librarian's UNIX 
workspace. 

m=) Add = add new records 

fee Update —- correct incorrect values 

(5) Delete - delete records 


1. DOUery/ Repose is 
If TQuery/Report is selected, a choice of the follow- 
ing reports is displayed on the terminal: 

O Scratch (1.1.1) - for scratch tapes available. 

O Periodic (1.1.2) - for aperiodic backups stored in the 
library (daily backup (db), weekly backup (wb), monthly 
backup (mb), or graduation backup (gb). 

O Individual (1.1.3) = backups belonging to individual 
staff (is), faculty (if), or students (iu) (before they 


graduate). 


e) Vendor (1.1.4) - vendor (v) tapes, no matter to whom 
they belong. 


e) Student (1.1.5) - graduated students and the tapes on 
which their accounts are logged. 


O Loaned (1.1.6) - a choice of Loaned Scratch Tapes 
(1.1.6.1) or Loaned Backup or Vendor Tapes (1.1. G22) 
(Date to Retire (1.1.7) tapes by retirement date). 

2- PQOWEry/ Re sere “(L212 
If PQuery/Report is selected, a choice of the same 
reports as in TQuery/Report, and one additional report is 
displayed. The additional report frame available is DUMP. 

O Dump (1.2.8) - Dump provides a choice of Live repemeaE 
They are each a "dump" of one of the five tables: Tape 
(1.2.8.1), Sets (1.2.8.2), File (ba2seeeiee even: 
(1.2.8.4), and Loan (1.2.8.5). They Contam aio see 
fields in the tables and are sorted by id number. 

The reports selected by the PQuery/Report frame will 
be written to your UNIX workspace file. The name of the file 


1s displayed on the terminal. The file may then be printed 


by using UNIX. 
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eee Add (1.3) 
Add should be selected whenever you desire to add any 
new records to the library. Add provides a choice of adding 


the following: 


Oo eeratch (1.3.1) = to add new scratch tapes 
O Vendor (1.3.2) - to add vendor tapes 
O Backup (1.3.3) - to be used when a backup has been read 


to a scratch tape. Backup provides a choice to add: 
- Pem@noctemodekUips (1.5.5.1). (type db, wh, mb; gb) or 
- imcrviducwer backups (l9fe.3.2) (type 1s, 1£, 1u) 


O Files (1.3.4) - 1S to be used to record the file paths 
which have been read to each tape. A choice of situ- 
ations is provided: 


_ NeweBackup or Vendor (1.3.4.1) = This frame will be 
used to add file paths at all times except the 
following 


= Olga Partial Individual (1.3.4.2) -—- This frame will 
be used only when an individual has requested a 
file path be read to tape and the librarian selects 
one of the individual's old partially used tapes to 
perform the read. The new file path should be 
recorded using the id of the old tape. 


4. Update (1.4) 

Update should be selected whenever you desire to 
change values which have been previously entered in the 
library. Update provides three choices for the changes: 

O Beror~s (1.4.1) = After a tape 1S read or written, the 
utility may indicate that the number of tape errors is 
different than those recorded in the library. Use 


Errors to update the number of errors and the date the 
MeweNcGLOrs are entered. 


or 


O Backup (1.4.2) = Backup enables updates to the follow- 
ing fields concerning backup or vendor tape records: 


dcreate, dretire, owner, advisor, contph, descr, sequ. 


O Loan (1.4.3) - Loan allows you to change fields edr, 
loanto, and lcntph. 


ae Delete (1.5) ~- Delete is the only frame which should 
be used to delete records from the library. The operations 
available are: 


O Loan - Use when a loaned tape is returned. This oper- 
ation deletes the record of the loan. 


O Backup - Use when a backup tape is retired or erased, 
but the tape is retained to be used as a scratch. All 
records of the backup are deleted from the library. 

The data regarding the physical characteristics and 
condition of the tape are retained. The tape keeps its 
id number, and must be left in its cabinet space. 


O Tape - When a tape is permanently disposed. All re- 
cords of the tape are deleted from the library. Only 
the id number of the cabinet space is retained and the 
TLS will define the id number as an empty slot. The 
tape must be removed from the cabinet space, and the id 
number must be removed from the tape. The cabinet 
Space retains the id number. 

Ge MAINTENANCE PROCEDURES 
As discussed in Chapter IV, Section J, the database ad- 
ministrator will be required to perform tasks to maintain 


peak performance, integrity, and the security of the data- 


base. The following is recommended. 


L3G 


1. Peak Performance 
On a monthly basis, run a system modification on each 
table in the database. This may be done by entering the 
following at the UNIX operating system level (% UNIX): 


% sysmod talibrary 
$ sysmod talibrary tape sets file student loan 


Zoe LNtegrity 
Only the librarians should be granted permits to 
affect the TLS tables. Destroy and define permits to tables 
as personnel are relieved of their librarian duties and new 
personnel are assigned. The procedure for- granting anc 
destroying permits is provided in Appendix F, Section D. 
Be security 
Only librarians should have access to the library. 
Access is made available by defining the TLS login symbol in 
the login files of new librarians. The login sign should be 
deleted from the login files of personnel relieved of librar- 
lan duties. The procedure for providing and denying access 


momalscussed in Appendix F, Section C. 
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